FIfireblocks
Blockchains & assets

Update the user’s metadata for an asset

Update the user’s metadata for an asset.

Endpoint Permission: Owner, Admin, Non-Signing Admin, NCW Admin, Signer, Editor.

patch/assets/{id}

Request

Path parameters

idstring required

The ID or legacyId of the asset

Headers

Idempotency-Keystring

A unique identifier for the request. If the request is sent multiple times with the same idempotency key, the server will return the same response as the first request. The idempotency key is valid for 24 hours.

Request body

Example request

{
  "metadata": {
    "note": {
      "text": "Pay attention to ETH gas fees"
    }
  }
}

Response

Updated asset user metadata

idstring required

The ID of the asset

legacyIdstring required

The Legacy ID of the asset

blockchainIdstring

The ID of the asset's blockchain

displayNamestring required

Asset's display name

displaySymbolstring required

Asset's display symbol

providerIdstring

The ID of the asset provider

peggedAssetIdstring

The ID of the pegged asset

assetsstring[]

List of asset IDs for virtual assets

assetClass'NATIVE' | 'FT' | 'FIAT' | 'NFT' | 'SFT' | 'VIRTUAL' required
decimalsnumber

Number of decimals for FIAT assets

Example response

{
  "id": "9f9f7062-df90-4fc0-8697-96685184358d",
  "legacyId": "USDT_ERC20",
  "blockchainId": "e85208ff-3b15-44e9-af14-0ed0280b2a15",
  "displayName": "Tether USD",
  "displaySymbol": "USDT",
  "providerId": "SOME_PROVIDER_ID",
  "peggedAssetId": "6ef19b84-2144-4d38-8056-d423199bce5e",
  "assets": [
    "6ef19b84-2144-4d38-8056-d423199bce5e"
  ],
  "assetClass": "FT",
  "decimals": 2,
  "onchain": {
    "symbol": "USDT",
    "name": "Tether USD",
    "address": "0xdAC17F958D2ee523a2206206994597C13D831ec7",
    "decimals": 6,
    "standards": [
      "ERC20"
    ]
  },
  "metadata": {
    "scope": "GLOBAL",
    "deprecationReferralId": "056776ab-9efa-4219-9820-9ece0cc4d90d",
    "website": "https://example.org",
    "media": [
      {
        "url": "https://example.com/image.png",
        "type": "image/svg+xml",
        "attributes": {
          "monochrome": true
        }
      }
    ],
    "note": {
      "text": "Pay attention to gas fees",
      "userId": "056776ab-9efa-4219-9820-9ece0cc4d90d",
      "userName": "Test test",
      "updatedAt": "2025-06-08T19:42:49.000Z"
    },
    "features": [
      "STABLECOIN"
    ]
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.