Overview
The Alerts API provides a centralized alert engine that monitors for mandate expiry, scope violations, jurisdiction flags, chain breaches, delegation depth exceeded, unregistered agents, and behavior anomalies. Alerts are categorized by type (mandate_expiring, scope_violation, jurisdiction_flag, chain_breach, delegation_depth_exceeded, unregistered_agent, behavior_anomaly) and severity (critical, high, medium, low, info). Delivery can be routed to one or more channels (in_app, email, slack, pagerduty).
Endpoints
| Method | Path | Description |
|---|---|---|
| GET | /alerts | List alerts, with optional acknowledged filter |
| PATCH | /alerts/:id/acknowledge | Acknowledge a specific alert |
| POST | /alerts | Create an alert programmatically |
Example
curl http://localhost:4000/alerts?acknowledged=false \
-H "Authorization: Bearer tr_abc123"