Stream Events

GET/v1/sessions/{session_id}/events/stream

Stream session events via Server-Sent Events (SSE).

Path parameters

stringsession_idrequired

The session ID (sess...)

session.status_running
  -> agent.tool_use -> agent.tool_result   (zero or more)
  -> agent.message                         (zero or more)
session.status_idle (stop_reason: end_turn)

Response200 OK

data: {"id":"sevt_01...","type":"session.status_running","processed_at":"2026-05-29T10:00:00Z"}

: heartbeat

data: {"id":"sevt_02...","type":"agent.tool_use","content":{"name":"web_search","input":{"query":"order 1234"}},"processed_at":"2026-05-29T10:00:01Z"}

data: {"id":"sevt_03...","type":"agent.message","content":[{"type":"text","text":"Your order #1234 shipped yesterday."}],"processed_at":"2026-05-29T10:00:03Z"}