DocumentationStream Events

Stream events

GET /api/v1/tasks/runs/{run_id}/events - SSE stream of execution events.

Stream events

GET /api/v1/tasks/runs/{run_id}/events

Returns a Server-Sent Events stream. Late-connecting clients receive all prior events from the database (replay buffer).

Query parameters

ParamTypeDescription
after_sequenceintSkip events up to this sequence (for reconnection via Last-Event-ID)

Response: text/event-stream

event: task.status
data: {"status":"running","run_id":"run_abc123..."}

event: task.step_start data: {"run_id":"run_abc123...","timestamp":"2026-02-27T00:00:01.000Z"}

event: task.agent.text-delta data: {"run_id":"run_abc123...","type":"text-delta","delta":"..."}

event: task.done data: {"run_id":"run_abc123...","status":"succeeded"} ```

The stream closes when the run reaches a terminal state.