Create a signed upload URL for an app
Creates or updates an app and returns pre-signed upload URLs for each file. Honours an optional Idempotency-Key header: a retry with the same key and body returns the same app and version with freshly signed URLs and Idempotent-Replayed: true, and never creates a second version. An Idempotency-Key is honoured for 7 days; after that it behaves like a fresh request. A replay whose version was deleted is a 404; a replay whose version already left the queued state is a 409 idempotency_key_consumed; a replay that cannot get the version lock within 5 s is a 409 idempotency_request_in_progress. Every response produced by a replay, including those 404/409 errors, carries Idempotent-Replayed: true. A same-key request still in flight after a 5 s wait is a 409 idempotency_request_in_progress (retry after Retry-After). If signing fails, nothing is persisted (with or without a key) and the same request, key included, can be retried.
Headers
Idempotency-Key: 1-255 printable ASCII characters. Same key with a different request body is a 422 idempotency_key_reused. A retryable in-flight duplicate is a 409 with Retry-After and x-should-retry: true; a terminal duplicate is a 409 with x-should-retry: false. A replay returns the current resource state with Idempotent-Replayed: true.
1 - 255^[\x21-\x7E]{1,255}$"b3f6a9f0-6f1a-4e9a-9e7a-9c9b6b6a5a3f"