API Endpoints
OpenSea

Modify collection metadata

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

Update an existing collection's metadata.

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 modifying collection metadata. Only the fields you send change. X (Twitter) and Discord are not free-text links: they are verified connections made by signing in to the account in Creator Studio, so they cannot be set here.

authorized_editors
array of strings | null

Authorized editors

authorized_editors
string | null

Banner image token

int32 | null
0 to 1000

Buyer-side creator fee basis points

boolean | null

Whether buyer-side creator fees are enabled

string | null

Buyer-side creator fee recipient

string | null

Collection category. Creators can no longer set or change it: any value other than the current one is rejected with 400, and OpenSea support handles category changes.

creator_fees
array of objects | null

Creator fees

creator_fees
string | null

Collection description

string | null
^$|^(https?)://.+$

Website URL shown on the collection page

boolean | null

Whether the collection is NSFW

boolean | null

Whether rarity is disabled

boolean | null

Whether trait offers are enabled

string | null

Logo image token

string | null
^[a-zA-Z0-9_-]+$

Medium username

string | null
^[\x20-\x7E]+$

Collection name

string | null
^[a-z0-9-]+$

New collection slug: 1 to 50 lowercase letters, numbers and hyphens. Renaming releases the old slug at once. It does not redirect: requests for it return 404 once cached responses expire (a few minutes), and any other collection can claim it, after which it serves that collection. Update links that use the old slug. Verified collections cannot change their slug.

string | null
^$|^(https?)://.+$

Collection Telegram URL

Responses

401

Invalid or missing API key

403

Forbidden

500

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

Updated 3 months ago

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

Updated 3 months ago