Update Notification Preferences
Push Notification Endpoints
Update Notification Preferences
Set the authenticated user’s disabled push notification types
PUT
Update Notification Preferences
Upserts the acting user’s push notification preferences. The request replaces the whole disabled-types set — send the complete set you want stored, not a delta. Duplicates are collapsed; only valid event type names are accepted.
Requires authentication. Acting-user-scoped: an end-user token (
Returned when a service/master key omits the required
Returned when
Returned when the
Authorization: Bearer <accessToken>) writes its own preferences. A service/master key acts on behalf of a named user via the optional body userId — a service key without userId is rejected, and an end-user token may not name a different user. Requires the push bundle.
Body Parameters
The complete set of event types to disable for push. Each value must be one of the server’s exact event type names (see the event palette) — unknown names are rejected. Pass
[] to re-enable everything (all-on).The acting user whose preferences are written. Service/master keys only — a service key must pass it; an end-user token infers it from the auth token and may not name a different user.
Response
Returns200 with the stored set (deduplicated).
Error Responses
Missing User ID — 400
Missing User ID — 400
userId (it has no implicit session user).Invalid Body — 400
Invalid Body — 400
disabledTypes contains a value that is not a recognized event type name.Bundle Not Installed — 403
Bundle Not Installed — 403
push bundle is not installed for this project.
