/tokenization/{id}/operationsMint NFT · ERC-721
Outcome - Creates the next NFT of an ERC-721 collection and sends it to receiverAddress. RoxCustody assigns the nftTokenId (1, 2, 3, …): read it from movements. Give the metadata as a URL you host (metadataUrl) or as a JSON object RoxCustody hosts for you (metadata): exactly one. The owner signs. Signer: RoxCustody signs with the token's owner (the OWNER role). Do not send a signer: signerWalletAddress or signerWalletId in params is refused. Templates: erc721-v1.
Path Parameters
idnumberToken ID
Body Parameters
operationstringrequiredAlways MINT for this operation.
paramsobjectrequiredThe operation details
Show child parameters (3)
receiverAddressstringrequiredAddress that receives the NFT
metadataUrlstringmax(2048)Metadata URL (http, https or ipfs). Give metadataUrl or metadata.
metadataobjectMetadata JSON (name, description, image, attributes, …), at most 16 KB. Give metadataUrl or metadata.
idempotencyKeystringYour unique key for this request. Repeating it with the same body returns the first transaction; with a different body it returns 409.
Responses
Response attributes
messagestringSuccess message
dataobjectThe transaction created
Show child attributes (2)
transactionIdnumberID of the transaction (type TOKEN_OPERATION). Follow it with Get Transaction Details or the transaction webhooks: the operation is done when it is COMPLETED.
dataobjectWhat the operation does, as shown on the transaction everywhere (API and webhooks)
Show child attributes (3)
operationstringThe operation
securityTokenobjectThe token
Show child attributes (1)
idnumberToken ID
movementsarrayOne MINT of the new NFT to receiverAddress
Show child attributes (6)
typestringMINT (tokens created: has to), BURN (tokens destroyed: has from) or TRANSFER (has from and to)
fromstringAddress the tokens leave. Absent on MINT.
tostringAddress the tokens reach. Absent on BURN.
amountstringFungible tokens: amount in whole units (for example "10.5"). Absent for an NFT.
nftTokenIdstringERC-721: the NFT that moves. Absent for fungible tokens.
metadataUrlstringERC-721 MINT: the metadata URL of the new NFT
statusnumberHTTP status code
Was this page helpful?