API Endpoints
OpenSea

Update collection metadata

patch
https://api.opensea.io/api/v2/collections//metadata

Update collection about, hero, overview, and logo image metadata. Only the collection owner or an authorized editor can update it; anyone else gets 403. The update applies in full or not at all: a media token that does not resolve fails the request with 400 and nothing is saved.

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 updating a collection's page: hero, about and overview. Top-level fields you leave out keep what is saved. Each field you send replaces what is saved for it, as its description says; overview in particular is replaced as a whole. Media fields take a token from POST /api/v2/collections/{slug}/media/{placement} or POST /api/v2/collections/{slug}/images/{image_type}. To keep media that is already saved, send its url from GET /api/v2/collections/{slug}/metadata as the token. Read the result back with GET /api/v2/collections/{slug}/metadata.

AboutMetadataRequest | null

About content. Leave it out to keep the saved about content.

HeroMetadataRequest | null

Hero media. Leave it out to keep the saved hero.

string | null

Collection logo image token

OverviewMetadataRequest | null

Overview modules. Sending overview replaces every saved module: a module type you leave out is removed, so sending only faq clears the narrative, content block and team modules. Leave overview out to keep the saved modules.

Responses

401

Invalid or missing API key

500

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

Updated 4 months ago

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

Updated 4 months ago