Streaming

Conceptual

Real-time event streams over SSE with resumable offsets.

Streaming exposes the run event log as it is written. Streams are resumable: reconnect with the last sequence number and no events are lost.

GET/v1/runs/{id}/events— Server-sent events stream

bash

curl -N https://api.pimsy.ai/v1/runs/run_7c1a9d/events?after=142 \
  -H "Authorization: Bearer $PIMSY_API_KEY" \
  -H "Accept: text/event-stream"

Stream excerpt

event: plan.created
data: {"sequence":143,"steps":7,"strategy":"investigate-then-act"}

event: step.started
data: {"sequence":144,"step_id":"s1","title":"Reproduce the failing checkout"}

event: tool.called
data: {"sequence":145,"tool":"sandbox.exec","step_id":"s1"}

event: observation.recorded
data: {"sequence":146,"step_id":"s1","summary":"Reproduced: 500 on EU address, null tax profile"}

event: step.completed
data: {"sequence":147,"step_id":"s1","duration_ms":38122}

Last updated 2026-09-15