Skip to content
LogoLogo

Update one typed notification preference

Update one typed notification preference

PATCH/api/v1/workspaces/{workspace_id}/notification-preferences/{category}

Uses expected_revision: 0 to create the first override and the returned positive revision for later compare-and-swap updates. Mandatory categories cannot disable Inbox delivery. Their email channel is also mandatory when email_available is true. A Workspace without the paid email entitlement cannot enable email.

Path Parameters

workspace_idRequired
string <uuid>
Example0198ac5e-f9b7-7000-8000-000000000001
categoryRequired
string
Values
assignmentmentioncommentduedependency

Header Parameters

X-CSRF-Token
string·min 1·max 200

Required when this operation uses browserSession; native bearer callers omit it because no ambient cookie is sent.

Request Body

application/json
web_enabledRequired
boolean
email_enabledRequired
boolean
push_enabledRequired
boolean
delivery_policyRequired
string
Values
immediatedaily_digestweekly_digest
expected_revisionRequired
integer·min 0

Responses