Upload drop item media

This response starts a three-step upload flow. First, request this context from OpenSea. Second, call the returned method at the returned URL. For POST, add every fields entry unchanged as a multipart text field, then add a file part containing the bytes. The file part must be last. Let the HTTP library generate the multipart boundary; do not set the overall multipart Content-Type header yourself. POST storage uploads normally return 204. For PUT, upload the raw bytes, use only headers explicitly required by the endpoint, and expect 200. Treat any 2xx storage response as success. The URL and fields are short-lived sensitive credentials. Do not log, persist, alter, or put them in tickets. Third, after storage succeeds, pass the returned token to the documented OpenSea API endpoint. Do not use the token before the storage upload succeeds. Pass each token as media_token to POST /api/v2/drops/{slug}/items or POST /api/v2/drops/{slug}/prereveal-item, as media_tokens to POST /api/v2/drops/{slug}/items/media/save, or as media_token to PUT /api/v2/drops/{slug}/items/{token_id}. To save a drop's items in bulk, pass an upload_batch_id on the upload requests and save with POST /api/v2/drops/{slug}/items/media/save-batch, which takes filenames rather than tokens. Passing media_tokens to POST /api/v2/drops/{slug}/items/media/save is deprecated.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
string
required

Collection slug

Body Params

Request body for uploading drop item media

filenames
array of strings
required
length between 1 and 50

Filenames to upload, one upload context per name. Between 1 and 50 per request, each unique within the request. Before its extension a filename may contain only letters, digits, periods, underscores, and hyphens (no spaces or slashes). The extension is matched ignoring case and must be one of: png, jpeg, jpg, avif, webp, gif, svg, tiff, ico, mp4, mov, mp3, wav, html, glb, gltf, pdf, m4v, webm. A request that breaks any rule is rejected with a 400 that names every offending filename.

filenames*
uuid

Optional. Uploads these files as part of one upload batch, so the drop can be saved with POST /api/v2/drops/{slug}/items/media/save-batch by filename instead of sending every media token back. Generate one UUID per set of files and pass it on every request for that set. Use a new UUID for each new set, so each filename is uploaded once per batch.

Responses

401

Invalid or missing API key

500

Internal server error. Please open a support ticket so OpenSea can investigate.

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
*/*