Edit metadata

Builds a metadata update for an existing asset, signed by authority, which must hold its update authority.

Replaces uri and the on-chain name, sellerFeeBasisPoints and creators. Fields under extendedMetadata are stored by mallow, not on-chain. For collection and maxSupply, omit the field to leave it unchanged or send null to clear it.

For a cnft or cnft-v2, authority must be the update authority of its collection (a Token Metadata collection for cnft, a Core collection for cnft-v2), or the tree creator or delegate when it has none; owning the asset is not enough. A compressed NFT's collection can't be changed here.

Authorization

ApiKeyAuth

x-api-key<token>

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Updates an existing asset's metadata. collection and maxSupply treat an omitted field as 'leave unchanged' and an explicit null as 'clear'.

authority*string

Wallet performing the edit (base58). Must hold update authority over the asset.

asset*string

Mint/asset address being edited (base58).

uri*string

New URI for the off-chain JSON metadata. Replaces the existing one.

nftMetadata*

Metadata for a mint or edit. name, sellerFeeBasisPoints and creators are written on-chain; everything under extendedMetadata is stored off-chain by mallow.

tokenStandard*TokenStandard

Asset standard. Solana: nft (Token Metadata), pnft (programmable NFT), cnft and cnft-v2 (compressed NFTs, Bubblegum v1 and v2), core and core-collection (Metaplex Core). Tezos: objkt. EVM: native, erc20, erc721, erc1155. Each endpoint accepts only some of these and returns 400 for the rest.

Value in

"nft"
"core"
"core-collection"
"pnft"
"cnft"
"cnft-v2"
"objkt"
"native"
"erc20"
"erc721"
"erc1155"

maxSupply?|

New print-run cap. Distinguishes absent from explicit null: omit the field to leave the cap unchanged, or send null to clear it and make the edition open.

collection?never

targetPriorityFeeLamports?integer

Priority fee per transaction, in lamports. By default it is a cap: mallow pays what the network currently needs, up to this amount (50,000 when omitted). Set exactPriorityFee to pay exactly this amount instead. The fee is never less than 15,000 lamports.

Formatuint64

exactPriorityFee?boolean

Pay targetPriorityFeeLamports exactly instead of treating it as a cap. Defaults to false.

blockhash?string

Recent blockhash to build the transaction with (base58). Omit it to let mallow supply one; identical requests a few seconds apart then return the same transaction.

editTarget?string

What the edit applies to: the asset itself (asset, the default) or the Core parent collection it belongs to (parent_collection).

Default"asset"

Value in

"asset"
"parent_collection"

newParentCollection?string

Move the asset into this Core parent collection (base58).

newGroupSigner?string

Keypair address co-signing the Core group change, when moving between groups.

Response Body

`application/json`

curl -X POST "https://example.com/v2/tx/nft/edit" \  -H "Content-Type: application/json" \  -d '{    "authority": "string",    "asset": "string",    "uri": "string",    "nftMetadata": {      "name": "string",      "sellerFeeBasisPoints": 0    },    "tokenStandard": "nft"  }'

{  "result": {    "tx": "string",    "setupTx": "string"  }}

Authorization

Request Body

Response Body

200application/json

400application/json

401application/json

429application/json

500application/json

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`