notifications
Durable recipient inbox and connected-browser preferences
Describe inbox and browser-delivery support
Describe inbox and browser-delivery support
Read the complete category/channel preference matrix
Read the complete category/channel preference matrix
Update category/channel preferences optimistically
Update category/channel preferences optimistically
List the recipient's durable notification inbox
List the recipient's durable notification inbox
Dismiss selected notifications
Dismiss selected notifications
Mark selected notifications read
Mark selected notifications read
Poll a resumable recipient-scoped notification change feed
Use tail=true without cursor/limit on first connection to suppress historical presentation. Expired cursors return resyncRequired=true.
Stream recipient-scoped durable notification changes
Authenticate with the same-origin HttpOnly cookie or an ordinary Authorization bearer session on fetch; credentials never belong in the URL. Personal access tokens use the polling endpoints instead, because this stream continually revalidates a rotating session without retaining a raw bearer. Supply a cursor in at most one of the cursor query parameter or Last-Event-ID header. With no cursor the stream starts at the current tail and emits ready. Each notification_changes event contains at most 50 ordered changes and its id is the next durable cursor. Missing retained history emits resync_required and closes. The server sends keepalive comments, revalidates authorization, limits concurrent streams, and relies on client polling as a lossless fallback.
Count unread durable notifications
Count unread durable notifications
Read one recipient-scoped notification
Read one recipient-scoped notification
Dismiss one notification
Dismiss one notification
Mark one notification read
Mark one notification read