How do I follow a run live with server-sent events?

curl -N https://api.agent.clatterlabs.xyz/v1/runs/RUN_ID/events \
  -H "Authorization: Bearer $CLATTER_API_KEY" \
  -H "X-Clatter-Account: $CLATTER_ACCOUNT_ID"

You need a key with runs:read. The response is text/event-stream; any SSE client works, or read the body line by line.

What you'll see#

event: status
data: {"status":"running"}

event: step
data: {"index":0,"type":"message","text":"I'll write hello.py and run it."}

event: done
data: {"id":"…","object":"run","status":"completed","output":"…"}

Read until done. One connection lasts up to 10 minutes; reconnect with ?after=N to continue. See Streaming events.