Mark All Notifications Read
Mark every notification the caller sees and hasn't read read (for the caller only).
API key access
notifications:write scope with an API key (ro_pat_...). A signed-in session uses the caller's role./api/v1/notifications/read-allAccess token from /api/v1/auth/login, or an API key (ro_pat_..., RO-176) from /api/v1/workspaces/current/api-keys: the key implies its workspace and needs the route's scope. MCP connectors (/api/v1/mcp only) may use an OAuth access token (ro_oat_..., RO-284).
In: header
Header Parameters
Id of the workspace to act on (must be a member).
Response Body
curl -X POST "http://localhost:8000/api/v1/notifications/read-all" \ -H "X-Workspace-Id: string"{
"updated": 0
}List Notifications
The caller's in-app notifications (their own, the workspace's, and the admins' for owners and admins), unread first, then newest first, with the unread count. Written by the core when a mailbox or sending domain auto-pauses or its health drops, a signal rule fires, an export is ready, a research batch finishes, a webhook endpoint is auto-disabled or a privacy export completes. Kept `NOTIFICATIONS_RETENTION_DAYS` (default 90).
Mark Notification Read
Mark one notification read for the caller (idempotent: their first `read_at` stays). Read state is per member: a workspace-wide notification stays unread for the other members.