Update User
Updates a user. A user token updates their own global profile; an API key updates the user’s account-specific profile override (account_id required).
Authorizations
An account API key, account scoped JWT, app API key, or user OAuth token.
Headers
Pins the request to a dated API version. When omitted, the request uses the original (2025-01-01) request/response shapes, so existing unversioned callers are never broken. Generated SDKs always send the latest version they were built against. An unrecognized value is rejected with a 400. The schemas documented here always describe the latest version.
"2026-07-01"
Path Parameters
User ID (prefixed user_), username, or me.
Query Parameters
The account whose profile override to update. Required for API key callers.
Response
user updated
User ID, prefixed user_.
The user's unique username
The user's display name
The user's biography
When the user was created, as an ISO 8601 timestamp
The user's profile picture, an object with a url
Total USD value across the user's balances with known exchange rates. Computed only on GET /users/me self-view for callers with balance-read scope; null otherwise.
Identity verification status for the user's individual (KYC) and business (KYB) profiles. Each is null until created, otherwise a status of not_started, pending, approved, or rejected.

