GET /user/preferences/{key}Get a user preference
Read a single user-scoped preference value by key.
Auth: Bearer token required
Path parameters
| Name | Type | Description |
|---|---|---|
key | string | Preference key |
Responses
| Status | Description | Schema |
|---|---|---|
200 | OK | UserPreference |
401 | Unauthorized | Error |
403 | Forbidden | Error |
PUT /user/preferences/{key}Set a user preference
Upsert a user-scoped preference value by key (max 64KB once JSON-encoded).
Auth: Bearer token required
Path parameters
| Name | Type | Description |
|---|---|---|
key | string | Preference key |
Request body (application/json)
| Field | Type | Description |
|---|---|---|
value | object | (required) |
Responses
| Status | Description | Schema |
|---|---|---|
200 | OK | UserPreference |
401 | Unauthorized | Error |
403 | Forbidden | Error |
DELETE /user/preferences/{key}Delete a user preference
Auth: Bearer token required
Path parameters
| Name | Type | Description |
|---|---|---|
key | string | Preference key |
Responses
| Status | Description | Schema |
|---|---|---|
200 | OK | object |
401 | Unauthorized | Error |
403 | Forbidden | Error |
Error| Field | Type | Description |
|---|---|---|
error | string | (required) |
code | string |
UserPreference| Field | Type | Description |
|---|---|---|
value | object |