Drops Endpoints

Save prereveal drop item

Changed on Nov 3, 2026

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.

post/api/v2/drops/{slug}/prereveal-item

Request

Base URL
https://api.opensea.io
Auth
API key in header x-api-key and OpenID Connect (https://auth.opensea.io/.well-known/openid-configuration, scopes: write:drops)
TypeScript
https://skmtc.dev/opensea/apis/opensea-api/docs/api/v2/drops/:slug/prereveal-item/post.ts
A function with typed inputs. Its response is checked against the schema.

Path parameters

slugstring required

Collection slug

Request body

descriptionstring

Item description

media_tokenstring required

Media token reference

media_typestring

Media type

namestring required

Item name

unrevealboolean

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.

Response

Prereveal drop item saved successfully

descriptionstring nullable

Item description

image_urlstring required

Item image URL

media_tokenstring required

Image media token

media_typestring nullable

Item media type