Account API
Account endpoints work with current user, metadata, avatar, and selected workspace.
All endpoints require Authorization: Bearer <token>, except cases when token is created after an external auth flow.
POST /api/v1/token
Creates or returns API token for authenticated identity.
Arguments: no path/query arguments.
Payload:
| Field | Required | Description |
|---|---|---|
app | Yes | Auth app/provider name. |
credentials | Yes | Provider-specific credentials object. |
Response: TokenResponse.
GET /api/v1/me
Returns current account, identity, tier, memberships, and selected workspace.
Arguments: none.
Payload: none.
Response: Me.
DELETE /api/v1/me
Deletes current account.
Arguments: none.
Payload: none.
Response: OperationResult.
PUT /api/v1/me/meta
Updates user metadata.
Arguments: none.
Payload:
| Field | Required | Description |
|---|---|---|
nickname | No | User display name, 2-80 characters. |
Response: Me.
POST /api/v1/me/avatar
Uploads current account avatar.
Arguments: none.
Payload:
| Field | Required | Description |
|---|---|---|
filename | Yes | Original filename. |
contentType | Yes | Image MIME type. |
data | Yes | Base64 image data. |
Response: AvatarUploadResult.
GET /api/v1/me/workspace
Returns selected workspace of current account.
Arguments: none.
Payload: none.
Response: CurrentWorkspaceResponse.
POST /api/v1/me/workspace
Changes selected workspace of current account.
Arguments: none.
Payload:
| Field | Required | Description |
|---|---|---|
workspace | Yes | Workspace fullname or null to reset selection. |
Response: CurrentWorkspaceResponse.
GET /api/v1/account/settings
Returns account settings.
Arguments: none.
Payload: none.
Response: AccountSettings.
POST /api/v1/account/settings
Saves account settings.
Arguments: none.
Payload: settings object. The concrete set of fields depends on the current account settings UI version.
Response: AccountSettings.