Skip to main content
PATCH
Update wallet

Authorizations

API-KEY
string
header
required

Your partner API key.

Headers

Api-Version
string
default:2026-09.1
required

The API version this request targets. Required on every /api/v0/* call. Format YYYY-MM.<release>; 2026-09.1 is the latest. The version that served the request is echoed back on the response. Missing, malformed or unsupported values are rejected with 400.

Pattern: ^\d{4}-\d{2}\.\d+$

Path Parameters

userId
string
required

Customer reference id, format cus_<20 chars> — never an internal UUID. Must belong to the authenticated partner.

walletId
string
required

Wallet reference id, format wlt_<20 chars>. Must belong to the customer named in the path.

Body

application/json

Send name, externalId, or both. Sending neither is a 400.

name
string

New label for the wallet.

externalId
string

Your own reference for the wallet. Optional. Stored at the custody layer — only name is mirrored into Endl's own record.

Response

Wallet updated. Unwrapped — the body is the updated wallet.

A wallet, unwrapped — the shape every wallet response returns (create, get, update, list).

walletId
string

Endl's wallet reference id (wlt_…). Never the custody provider's id.

userId
string

The customer (cus_…) the wallet belongs to.

network
string

The network the wallet was created on.

address
string

The on-chain address. Live from creation.

name
string

The wallet's label.

status
string

The custody provider's status, in its own vocabulary. Compare case-insensitively.

currency
string

A local default stamped at creation — USDT on a Tron wallet (Tron or TronNile), USDC on every other network. Not a restriction, and not a reading of the chain.

dateCreated
string

When the wallet was created.