List notifications
GET /v1/notifications — Recent in-app notifications (newest first) plus an `unread_count`. A notification is recorded each time a custom agent f
GET /v1/notifications
Recent in-app notifications (newest first) plus an unread_count. A notification is recorded each time a custom agent fires on its own (scheduled / event / once) and its in-app config opts into the outcome. Optional ?limit= (default 50, maximum 200). On desktop this also includes local session events and server notifications belonging to the signed-in account. server_owner is an opaque account scope, null while signed out, and absent when the desktop relay is disabled. Server rows have source: server and include server-authored title/body plus presentation and historical. presentation independently selects system (false, always, unfocused-only), inbox (boolean), and toast (false, focused-only). Only inbox rows contribute to unread counts. server_deliveries contains current-process live intents, including system-only rows; historical/cold-start inbox entries never cause system or toast replay. Unknown internal landing paths fall back to home. Desktop ordinary Chat/Coding results and waiting-input events are system-only while unfocused. Accept-Language and X-Minara-Client-Version update this installation's subscription context only. Server read/delete operations affect the current account; clearing visible rows retains delivery deduplication receipts. The notifications WebSocket channel emits notifications_changed with empty data when the server inbox changes; fetch this endpoint to reconcile.
| Method | GET |
| Path | /v1/notifications |
| Auth | Authorization: Bearer <token> required when GATEWAY_AUTH_TOKEN is set |
| Category | notifications |