SSE Transport

Ocelloids Services Server-Sent Events transport

Base URL: https://api.ocelloids.net/sse

The Server-Sent Events (SSE) transport provides a lightweight, one-way real-time stream from Ocelloids agents to your client over a long-lived HTTP connection. Clients connect with an authenticated GET request, and the server continuously pushes events using the standard text/event-stream format.

SSE is ideal for dashboards and browser applications that only require server to client updates.

How It Works

Client opens an SSE endpoint:

GET /sse/<agent>/<stream-name>

Server keeps the connection open and sends events like:

event: <type>
data: <JSON>

Supports automatic reconnection and Last-Event-ID for resuming streams.

Example

curl -N \
  -H "Authorization: Bearer <YOUR_API_KEY>" \
  -H "Accept: text/event-stream" \
  https://api.ocelloids.net/sse/<agent>/<stream-name>