Users
Read and update the authenticated user — profile, avatar, and preferences.
Endpoints under /users/me act on the authenticated user — the user the bearer token belongs to. There are no path parameters for identifying the user; it is always derived from the token.
Session and API-key management are not part of the public API — manage those from your account settings. See Authentication.
Endpoints
| Method | Endpoint | Description |
|---|---|---|
GET | /users/me | Get the user's profile |
PUT | /users/me/name | Update the display name |
PUT | /users/me/avatar | Upload a profile picture |
DELETE | /users/me/avatar | Remove the profile picture |
GET | /users/me/preferences | Get preferences |
PATCH | /users/me/preferences | Update preferences |
The user object
{
"id": "0190f8a1-2b3c-7d4e-8f90-1a2b3c4d5e6f",
"name": "Ada Lovelace",
"email": "[email protected]",
"avatarUrl": "https://assets.gox.ai/tmr/avatars/0190f8a1.png",
"preferences": {
"appearance": "light",
"notifications": {
"email": { "billing": true, "productUpdates": true, "promotional": false }
}
},
"createdAt": "2026-01-12T08:15:00.000Z"
}