AddressesИзменить метаданные адреса

Изменить метаданные адреса

Частичное обновление метаданных адреса его ВЛАДЕЛЬЦЕМ: label, description, tags, logoUri (логотип), color, emoji. Правит только владелец (createdById из сессии) — даже admin чужой адрес не меняет (чужой/несуществующий → 404). On-chain данные, баланс и derivation path не затрагиваются.

curl -X PATCH "https://policy-engine-rest.ezig.workers.dev/api/v1/vaults/demo_vault/addresses/example_string" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -d '{
  "label": "example_string",
  "description": "example_string",
  "tags": [
    "example_string"
  ],
  "logoUri": "example_string",
  "color": "example_string",
  "emoji": "example_string"
}'
{
  "id": "cmr3f41z20001psp7phmyapw3",
  "address": "TQ5kohbBSdorGoDBmCGUmDL7RUvNr75mBC",
  "derivationPath": "m/44/195/0/0/1/1/0",
  "network": "tron",
  "pathIndex": 42,
  "segmentsJson": {
    "app_id": 0,
    "purpose": 1,
    "asset": 1,
    "stage": 0
  },
  "label": "example_string",
  "description": "example_string",
  "tagsJson": [
    "example_string"
  ],
  "logoUri": "example_string",
  "color": "#000",
  "emoji": "💳",
  "balance": "1500000",
  "balances": [
    {
      "tokenId": "example_string",
      "asset": "usdt",
      "symbol": "USDT",
      "decimals": 42,
      "available": "example_string",
      "availableDecimal": "1.951234",
      "reserved": "example_string",
      "reservedDecimal": "example_string"
    }
  ],
  "tokenId": "example_string",
  "createdAt": "2026-07-02T11:25:15.134Z",
  "asset": "usdt",
  "assetName": "John Doe",
  "assetSymbol": "USDT",
  "balanceDecimal": "1.5",
  "owner": {
    "id": "example_string",
    "name": "John Doe",
    "username": "John Doe",
    "image": "example_string",
    "color": "example_string",
    "emoji": "example_string"
  },
  "access": {
    "isOwner": true,
    "isAdmin": true,
    "canView": true,
    "canTransfer": true
  }
}
PATCH
/api/v1/vaults/{code}/addresses/{id}
PATCH
Base URLstring

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

Bearer Token
Bearer Tokenstring
Required

better-auth session token. Мобилка/сервисы. Веб использует cookie.

better-auth session token. Мобилка/сервисы. Веб использует cookie.
API Key (cookie: better-auth.session_token)
path
codestring
Required

Уникальный код Vault'а (slug)

path
idstring
Required

id адреса (cuid)

Content-Typestring
Required

The media type of the request body

Options: application/json
logoUristring

Ссылка на логотип; null — очистить

colorstring

HEX-цвет; null — очистить

emojistring

Emoji-иконка; null — очистить

Request Preview
Response

Response will appear here after sending the request

Authentication

header
Authorizationstring
Required

Bearer token. better-auth session token. Мобилка/сервисы. Веб использует cookie.

path
parameterstring
Required

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

Path Parameters

codestring
Required

Уникальный код Vault'а (slug)

Example:
demo_vault
idstring
Required

id адреса (cuid)

Body

application/json
logoUristring

Ссылка на логотип; null — очистить

colorstring

HEX-цвет; null — очистить

emojistring

Emoji-иконка; null — очистить

Responses

idstring
Required

cuid

addressstring
Required

On-chain адрес из Wallet Service

derivationPathstring
Required
networkstring
Required
pathIndexinteger
Required

Значение dynamic-сегмента (incrementing)

segmentsJsonobject
Required

code сегмента → pathId (без network и index)

labelstring
Required
descriptionstring
Required
tagsJsonstring
Required
logoUristring
Required

Ссылка на изображение логотипа адреса

colorstring
Required

HEX-цвет

emojistring
Required

Emoji-иконка

balancestring
Required

raw smallest units

balancesarray
Required

Балансы по ВСЕМ токенам адреса — из ledger, единственного источника истины. Токен без счёта в ledger в список не попадает: «ноль» и «такого токена здесь не было» — разные факты

tokenIdstring
Required

Денормализованный актив адреса — FK на Token (из asset-сегмента пути)

createdAtstring
Required
assetstring
Required

Код токена адреса (из segmentsJson + asset route)

assetNamestring
Required
assetSymbolstring
Required
balanceDecimalstring
Required

Баланс в decimal (по token.decimals)

ownerstring
Required

Владелец адреса (создатель) с UI-метаданными

accessobject
Required

Права текущего пользователя на этот адрес