PUT
/
v1
/
ip
/
collections
/
{collectionId}
Create Collection (Idempotent)
curl --request PUT \
  --url https://staging.crossmint.com/api/v1/ip/collections/{collectionId} \
  --header 'Content-Type: application/json' \
  --header 'X-API-KEY: <x-api-key>' \
  --data '{
  "reuploadLinkedFiles": true,
  "metadata": {
    "name": "My Collection",
    "symbol": "MYCOL",
    "description": "My Collection Description",
    "image": "https://example.com/image.png"
  },
  "chain": "story-testnet"
}'
{
  "id": "d290f1ee-6c54-4b01-90e6-d701748f0851",
  "actionId": "d290f1ee-6c54-4b01-90e6-d701748f0851",
  "metadata": {
    "name": "My Collection",
    "symbol": "MYCOL",
    "description": "My Collection Description",
    "image": "https://example.com/image.png"
  },
  "onChain": {
    "chain": "story-testnet",
    "contractAddress": "0x123"
  }
}
This API is still under development. Contact support for early access.

Headers

​
X-API-KEY
string
required

API key required for authentication

Path Parameters

​
collectionId
string
required

Body

application/json

Story Protocol collection creation input

Response

201 - application/json

Collection created

Story Protocol collection creation output