Save prereveal drop item

Sets the placeholder every token shows until the drop is revealed: one name, description, and image, from a media_token issued by POST /api/v2/drops/{slug}/items/media. It saves a placeholder base URI to the draft, so publish afterwards to put it onchain. Running POST /api/v2/drops/{slug}/metadata/ipfs later replaces it with the real metadata.

Saving it on a revealed drop changes only the stored item and leaves the drop revealed. To put the placeholder back over a revealed drop on purpose, send unreveal=true: the placeholder is written to the draft, and the next publish un-reveals the drop.

Only ERC-721 SeaDrop V1 drops have a prereveal item; any other drop type returns 400.

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 saving a prereveal drop item

string

Item description

string
required
length ≥ 1

Media token reference

string

Media type

string
required
length between 0 and 100

Item name

boolean
Defaults to false

Set to true to put this placeholder back over a revealed drop on purpose. The save then always writes the placeholder to the draft, and the next publish un-reveals the drop. Defaults to false, which leaves a revealed drop's base URI as it is.

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:
*/*