Reference
Streaming (SSE)
Real-time confirmation events over Server-Sent Events.
Endpoint Map
| Method | Path | Auth | Purpose |
|---|---|---|---|
GET | /api/v1/stream | JWT | Open SSE stream |
GET | /api/v1/stream/pending | JWT | Polling fallback for pending requests |
Open SSE Stream
GET /api/v1/stream
Authorization: Bearer <jwt>
Accept: text/event-streamThe stream sends:
connected(initial handshake)CONFIRMATION_REQUIREDCONFIRMATION_RESOLVEDheartbeat(every 30s)
Example Events
event: connected
data: {"userId":"usr_...","timestamp":"..."}
event: CONFIRMATION_REQUIRED
data: {"id":"...","tool":{"name":"transfer_money"},"risk":{"level":"high"},"timestamp":"..."}
event: CONFIRMATION_RESOLVED
data: {"id":"...","confirmed":true,"timestamp":"..."}Polling Fallback
GET /api/v1/stream/pending
Authorization: Bearer <jwt>Returns { data: [...] } with pending confirmation payloads.