Notifications

Manages the current user's notification feed and delivery preferences: listing notifications, marking them read, checking the unread count, and reading or updating per-channel and per-category preferences.

📄️ Returns a page of the current user's notifications, newest first.

Uses cursor-based (keyset) pagination rather than page numbers. Leave `cursor` empty for

📄️ Marks a single notification as read.

Idempotent: marking an already-read notification as read again succeeds.

📄️ Marks all of the current user's notifications as read.

Performs the mark all as read action for the selected notification.

📄️ Returns the number of unread notifications for the current user.

Convenient for rendering an unread badge without fetching the full feed.

📄️ Returns the current user's notification delivery preferences.

Preferences consist of a set of global per-channel toggles plus an optional per-category

📄️ Replaces the current user's notification delivery preferences.

This is a full replacement, not a partial update: the request must contain the global channel