Notifications

In-app notification system with real-time delivery via Server-Sent Events (SSE). Notifications keep you informed about deployments, alerts, and system events without leaving the dashboard.

Access

Click the bell icon in the top navigation bar, or go to /notifications for the full history.

Key Features

• Real-time push delivery using SSE (no polling)
• Notification bell with unread count badge
• Full notification history with read/unread status
• Mark individual notifications or all as read
• Notifications generated by deployments, alerts, container events, and system messages

Usage

Receiving Notifications

Notifications arrive in real time while you have Ops Atlas open. The bell icon in the navigation bar shows an unread count badge. Click it to see recent notifications in a dropdown.

Notification Types

Type	Trigger
Deployment	A deployment started, completed, or failed
Alert	An alert rule was triggered or resolved
Container	A container changed state unexpectedly
System	System-level messages (updates, maintenance)

Managing Notifications

From the dropdown or the full /notifications page:

• Click a notification to view its details and mark it as read
• Click Mark All as Read to clear the unread badge
• Notifications are retained for 30 days by default

Real-Time Delivery

Notifications use SSE to stream events from the backend to the browser. The connection is established automatically when you load Ops Atlas and reconnects if interrupted.

TIP

If notifications stop arriving, check that your browser tab is active and that no proxy or firewall is terminating long-lived HTTP connections.

API

GET  /api/notifications              # List notifications (paginated)
GET  /api/notifications/stream       # SSE stream for real-time delivery
PUT  /api/notifications/{id}/read    # Mark a notification as read
PUT  /api/notifications/read-all     # Mark all as read
GET  /api/notifications/unread-count # Get unread count

Managed by NotificationController.