Edit NFT by Locator

Edit a minted NFT’s metadata using a Crossmint NFT locator.

API scope required: nfts.update

This is an alpha API and subject to change.

Currently, this route is restricted to EVM NFTs only.

Locator format: {chain}:{contractAddress}:{tokenId}

Example: polygon:0x5af0d9827e0c53e4799bb226655a1de152a425a5:23

Authorizations

X-API-KEY

string

header

required

Obtained in the Crossmint developer console

Path Parameters

locator

string

required

The locator of the NFT, which includes the blockchain, contract address, and token ID.

Body

application/json

metadata

object

required

Show child attributes

metadata.description

string

required

A brief description of the NFT (Max length: 64)

Maximum length: 64

metadata.image

string

required

Direct link to your NFT image

metadata.name

string

required

The name of your NFT (Max length: 32)

Maximum length: 32

metadata.animation_url

string

EVM only

See more info here

metadata.attributes

object[]

Add attributes to your NFT

Show child attributes

metadata.attributes.trait_type

string

required

The name of the trait

metadata.attributes.value

string

required

The value of the trait

metadata.attributes.display_type

enum<string>

Display name of your attribute

Available options:

boost_number,

boost_percentage,

number

reuploadLinkedFiles

boolean

required

Any URLs in the metadata object will be resolved and reuploaded to IPFS [Default: true]

Response

200 - application/json

action

string

actionId

string

completedAt

string

The time this operation completed in UTC.

This is only present when status is succeeded

data

object

Show child attributes

data.chain

string

data.changes

string[]

data.collection

object

Show child attributes

data.collection.contractAddress

string

data.collection.id

string

data.token

object

Show child attributes

data.token.id

string

data.token.owner

object

Show child attributes

data.token.owner.walletAddress

string

data.token.tokenId

string

data.txId

string

The onchain transaction ID related to the request.

This is only present when status is succeeded

resource

string

startedAt

string

status

string