#UserPreferences

---

#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

Responses

Status	Description	Schema
200	Preference value (null if unset)	UserPreference
401	No user session	Error

---

#PUT /user/preferences/{key}

Set a user preference

Upsert a user-scoped preference value by key (max 64KB).

Auth: Bearer token required

Path parameters

Name	Type	Description
key	string

Request body (application/json)

Field	Type	Description
value	object

Responses

Status	Description	Schema
200	Stored preference value	UserPreference
400	Invalid JSON, missing value, or over 64KB	Error
401	No user session	Error

---

#DELETE /user/preferences/{key}

Delete a user preference

Auth: Bearer token required

Path parameters

Name	Type	Description
key	string

Responses

Status	Description	Schema
204	Deleted (no content)
401	No user session	Error

#Schemas

#Error

Field	Type	Description
error	string	(required)
code	string

#UserPreference

Field	Type	Description
value	object