Skip to content

Create or update a category preference

PUT
/api/v1/user-category-preference
curl --request PUT \
--url https://example.com/api/v1/user-category-preference \
--header 'Content-Type: application/json' \
--data '{ "category": "example", "visible": true }'
Media type application/json
object
category
required

Category ID (15 chars)

string
visible
required
boolean
Example generated
{
"category": "example",
"visible": true
}

Saved category preference

Media type application/json
object
id
required

Preference ID (15 chars)

string
user
required

User ID (15 chars)

string
category
required

Category ID (15 chars)

string
visible
required
boolean
priority
integer
nullable
created
string format: date-time
updated
string format: date-time
Example generated
{
"id": "example",
"user": "example",
"category": "example",
"visible": true,
"priority": 1,
"created": "2026-04-15T12:00:00Z",
"updated": "2026-04-15T12:00:00Z"
}

Bad Request

Unauthorized

Internal Server Error