Skip to content
Documentation/API reference
API · profile

Update profile

PATCH /api/v2/profile

Authorization

Authenticated user session (use inboxit login). Use the CLI login flow; a workspace API key cannot call this operation.

Parameters

All resource access is checked against the selected workspace and user permissions.

NameTypeContract
namestring · requiredTrimmed 1–80 characters

Request

Run inboxit login first. The CLI supplies authenticated user credentials.

Example
inboxit profile update --data @request.json

JSON body

Save this JSON as request.json for the request above. Replace example values with your own.

Example
{
  "name": "Your Name"
}

Response

HTTP 200. Example values are illustrative; excerpts are marked.

Example
{
  "display_name": "Your Name",
  "avatar": null
}

Behavior & errors

Updates display name, not email or password. Common errors: 400 invalid input, 401 unauthenticated, 403 insufficient permission, 404 missing/inaccessible resource, 409 conflict, 429 rate/usage limit, 503 service unavailable. See Errors & retries for recovery guidance.