Skip to main content
PUT
/
v1-alpha1
/
minting
/
collections
/
{collectionId}
/
royalties
Set Royalties
curl --request PUT \
  --url https://staging.crossmint.com/api/v1-alpha1/minting/collections/{collectionId}/royalties \
  --header 'Content-Type: application/json' \
  --header 'X-API-KEY: <api-key>' \
  --data '
{
  "recipients": [
    {
      "address": "0x71C...",
      "basisPoints": 100
    }
  ]
}
'
{
  "error": true,
  "message": "Invalid arguments or empty parameter <missing parameter>."
}

Documentation Index

Fetch the complete documentation index at: https://docs.crossmint.com/llms.txt

Use this file to discover all available pages before exploring further.

This is an alpha API and subject to change.

Authorizations

​
X-API-KEY
string
header
required

Obtained in the Crossmint developer console

Path Parameters

​
collectionId
string
required

This is the identifier for the collection related to the request. Every project has default collections: default-solana and default-polygon.

The create-collection API will result in collections with UUID formatted collectionId. Example: 9c82ef99-617f-497d-9abb-fd355291681b

The create-collection-idempotent API allows you to specify an arbitrary identifier during the initial request. Example: your-custom-identifier

Body

application/json
​
recipients
object[]

List of royalty recipients. Note: EVM collections only support a single recipient. Use a contract splitter as recipient in order to send payments to multiple addresses.

Response

No-content success response indicating that the request is being processed.