Create a media upload session
Step one of three. Returns an upload token and a direct upload URL; send the file bytes to that URL with the returned headers, then attach the token to a product. The URL points at object storage, not at this API. A token is consumed by a successful attach and cannot be reused; a rejected attach leaves it usable.
Requires the products permission at write. An API key holds a permission at the lower of its own level (read for a read-only key) and its holder’s role; a key without it is refused with 403.
Authorizations
Headers
Optional. At most 255 characters of valid UTF-8 with no NUL byte. When sent, a retry that carries the same key and the same body returns the original response instead of performing the write a second time, and the same key with a different body is refused with 409 idempotency_conflict. Keys are remembered for 24 hours. A returned original response carries the header Idempotent-Replayed: true. Without the header the write is performed every time it is sent.
255Was this page helpful?