Edit NFT Metadata

Use this API to create dynamic NFTs that evolve over time, or correct mistakes.

Ensure your API key is a server side key with the scope nfts.update

To start, first make sure you have a reference to the collectionId and NFT ID you would have obtained after the mint has completed. The NFT ID is a UUID that references the NFT in Crossmint’s internal systems. If you want to update by tokenId this is supported on EVM collections.

curl --request PATCH \
  --url https://staging.crossmint.com/api/2022-06-09/collections/{collectionId}/nfts/{nftId} \
  --header 'Content-Type: application/json' \
  --header 'X-API-KEY: <api-key>' \
  --data '{
  "metadata": {
    "description": "My NFT created via the mint API!",
    "image": "https://www.crossmint.com/assets/crossmint/logo.png",
    "name": "Crossmint Example NFT",
    "attributes": [
        "display_type": "boost_number",
        "trait_type": "<string>",
        "value": "<string>"
  "reuploadLinkedFiles": true

Try out live in the API playground: Edit NFT

If you’re working with an EVM collection you can use the Edit NFT by Locator endpoint

The new metadata object fully replaces the old one. It doesn’t only modify the fields you enter.

Burn an NFT

Burning an NFT effectively removes it from circulation. This endpoint requires an API key with the nfts.delete scope.

curl --request DELETE \
  --url https://staging.crossmint.com/api/2022-06-09/collections/{collectionId}/nfts/{nftId} \
  --header 'X-API-KEY: <api-key>'

Test this endpoint out live in the API playground: Burn NFT