MINARA

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.

MethodGET
Path/v1/notifications
AuthAuthorization: Bearer <token> required when GATEWAY_AUTH_TOKEN is set
Categorynotifications

On this page