Skip to main content
POST
Create Collection (Idempotent)
This API is still under development. Contact support for early access.

Headers

X-API-KEY
string
required

API key required for authentication

Body

application/json
metadata
object
required

Story Protocol collection metadata

Example:
chain
string
required

The chain of the collection

Example:

"story-testnet"

reuploadLinkedFiles
boolean
default:true

Controls whether external files (like images) in the metadata should be reuploaded to decentralized storage (IPFS) (true) or referenced with their original URLs (false). Default is True.

Example:

true

supplyLimit
number

The supply limit of the collection

Example:

100

Response

201 - application/json

Collection created

id
string
required

The id of the collection

Example:

"d290f1ee-6c54-4b01-90e6-d701748f0851"

actionId
string
required

The action id of the collection

Example:

"d290f1ee-6c54-4b01-90e6-d701748f0851"

metadata
object
required

Story Protocol collection metadata response

Example:
onChain
object
required