Stream notifications for all of your queries over a single connection (SSE).

Use this instead of opening one /queries/{queryId}/stream per query. Events for every query you own arrive on one connection; correlate them with data.queryId.

Cost

Free.

Auth

Required header:

x-elfa-api-key: <api_key>

Response Format (SSE)

id: <outbox-event-uuid>
event: notification
data: {"status":"triggered","title":"...","body":"...","queryId":"<uuid>","timestamp":1743379200000}

A : keep-alive comment is sent every 15s. Only notifications tied to a query are delivered. Events are live-only — there is no replay, and Last-Event-ID is ignored.

Lifecycle

Open the stream after creating at least one query: the request returns 410 when you have no active queries. Once your last query reaches a terminal state and all of its notifications have been delivered, the stream emits and then closes:

event: end
data: {"code":"USER_STREAM_CLOSED"}