Edit metadata

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

Replaces uri and the on-chain fields carried in nftMetadata (name, sellerFeeBasisPoints, creators). Off-chain fields under extendedMetadata (description, attributes, tags, media, NSFW flag) are stored by mallow rather than on-chain.

collection and maxSupply distinguish absent from explicit null: omit the field to leave it unchanged, or send null to clear it. Use editTarget to retarget the edit at the asset itself (asset, the default) or at its parent_collection, and newParentCollection / newGroupSigner to move the asset between Core groups.

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, which selects the program the transaction is built against. Solana: nft (Token Metadata), pnft (programmable NFT), cnft (compressed), core / core-collection (Metaplex Core). objkt is a Tezos asset. EVM: native, erc20, erc721, erc1155. Individual endpoints accept only a subset — an unsupported standard is rejected with a 400.

Value in

"nft"
"core"
"core-collection"
"pnft"
"cnft"
"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

Total priority fee to target for this transaction, in lamports. The builder derives the compute-unit price from it and the transaction's compute budget. Omit to let mallow pick a fee from current network conditions.

Formatuint64

blockhash?string

Recent blockhash to stamp onto the transaction, base58. Omit to let mallow supply one — mallow's is cached for up to 10 seconds, so two identical requests inside that window compile the same transaction, with the same signature once signed. Supply your own to control the expiry window, or when otherwise-identical requests must produce distinct transactions. Rejected with a 400 if it is not valid base58; a blockhash the cluster has already aged out builds fine and fails at send time.

editTarget?string

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

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"  }}

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`