Skip to main content
GET
Subscribe to a turn stream

Authorizations

Authorization
string
header
required

Caller credential (Authorization: Bearer <token>). Required on protected routes when auth is enabled. Browser sessions may use the HttpOnly id_token or accessToken cookie instead.

Path Parameters

session_id
string
required

Session identifier.

Required string length: 1 - 64
turn_id
string
required

Turn identifier.

Minimum string length: 1

Query Parameters

after_sequence_number
integer | null

Deprecated. Rejected on new turns. Use from_event_id or after_event_id instead.

Required range: x >= 0
from_event_id
string

Inclusive cursor. Replay starts at the entry with this event id

Minimum string length: 1
after_event_id
string

Exclusive cursor. Replay starts after the last entry with this event id.

Minimum string length: 1

Response

Server-Sent Events stream of turn events (deltas and lifecycle).

created_at
string
required

ISO 8601 event timestamp.

id
string
required

Unique identifier for the event (monotonic ULID).

thread_id
string
required

Thread that emitted this message (main for the root agent).

type
enum<string>
required

Complete assistant model message.

Available options:
model.message
content

Assistant message content as text or content parts.

finish_reason
enum<string> | null

Model finish reason; null when the provider omitted it.

Available options:
stop,
length,
tool_calls,
content_filter,
function_call
model
object
name
string

Optional participant name.

reasoning_content
string
refusal
string | null

Optional refusal text.

tool_calls
object[]
usage
object