Conversation Event Stream
Watch one conversation happen: a snapshot, then every item and turn live.
Frames: conversation.snapshot (the conversation and its items, sent first
and on every reconnect), item.created, item.delivery_updated, turn and
turn.failed (turn lifecycle), and assistant.started / assistant.delta
/ assistant.completed for the reply as it is generated.
Nothing here is canonical — a dropped frame is recovered by reconnecting
(the snapshot re-syncs) or by list_conversation_items.
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Path Parameters
Response
A text/event-stream that stays open. Each frame is event: <name> followed by data: <json>, and the JSON repeats the name in its event field so one value identifies the frame. A line starting : is a keep-alive, sent every 15s so idle proxies do not close the connection. Read it with an SSE client (EventSource, httpx-sse) — the body is never a single JSON document.
The response is of type any.