Skip to main content
GET
Subscribe to a running turn

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

Exclusive resume cursor: replay only events with a sequence number greater than this value. Omit to start from the beginning of the live buffer.

Required range: x >= 0

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
name
string

Optional participant name.

reasoning_content
string
refusal
string | null

Optional refusal text.

tool_calls
object[]
usage
object