TokensUpdate a token

Update a token

Partial update: symbol, name, logoUri (logo), and enabled (kill switch: for a disabled token, transfers are rejected with TOKEN_NOT_FOUND, the webhook ignores events, and new policies/vaults can't reference it; existing data and ledger accounts are left untouched). code/contractAddress/decimals are immutable, since the ledger, policies, and derivation structures reference them.

curl -X PATCH "https://policy-engine-rest.ezig.workers.dev/api/v1/tokens/example_string" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -d '{
  "symbol": "example_string",
  "name": "John Doe",
  "enabled": true,
  "logoUri": "example_string"
}'
{
  "id": "cmr3f41z20001psp7phmyapw3",
  "code": "usdt",
  "symbol": "USDT",
  "name": "Tether USD",
  "networkId": "example_string",
  "contractAddress": "TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t",
  "decimals": 6,
  "isNative": true,
  "enabled": true,
  "logoUri": "https://cdn.example.com/tokens/usdt.png",
  "createdAt": "2026-07-02T11:25:15.134000Z",
  "updatedAt": "2026-07-02T11:25:15.134000Z",
  "network": {
    "id": "cmr3f41z20001psp7phmyapw3",
    "coinType": 195,
    "code": "tron_network",
    "slug": "tron",
    "name": "Tron"
  }
}
PATCH
/api/v1/tokens/{id}
PATCH
Base URLstring

Target server for requests. Edit to use your own host.

Bearer Token
Bearer Tokenstring
Required

Session token. Mobile/services. The web uses a cookie.

Session token. Mobile/services. The web uses a cookie.
API Key (cookie: session_token)
session_tokenstring
Required

API key (sent in cookie)

path
idstring
Required

Token id (cuid)

Content-Typestring
Required

The media type of the request body

Options: application/json
symbolstring
Min length: 1
namestring
Min length: 1
enabledboolean

disabled: transfers of this token → TOKEN_NOT_FOUND, the webhook ignores events, policies and vaults can't reference it

logoUristring

Link to the token's logo; null clears it

Request Preview
Response

Response will appear here after sending the request

Authentication

header
Authorizationstring
Required

Bearer token. Session token. Mobile/services. The web uses a cookie.

path
parameterstring
Required

API Key for authentication. Provide your API key in the cookie.

Path Parameters

idstring
Required

Token id (cuid)

Body

application/json
enabledboolean

disabled: transfers of this token → TOKEN_NOT_FOUND, the webhook ignores events, policies and vaults can't reference it

logoUristring

Link to the token's logo; null clears it

Responses

idstring
Required

cuid

codestring
Required

App-level slug; used in policies and transactions

symbolstring
Required
namestring
Required
networkIdstring
Required
contractAddressstring
Required

Smart contract address. Unique within a network. null for the native coin

decimalsinteger
Required
isNativeboolean
Required

true means the network's native coin (TRX). One per network

enabledboolean
Required
logoUristring
Required

Link to the token's logo image

createdAtstring
Required
updatedAtstring
Required
networkobject
Required