Skip to main content
GET
Stream events

Authorizations

Authorization
string
header
required

An opaque Omnara personal or organization bearer token.

Headers

Last-Event-ID
integer<int64>
Required range: x >= 0

Path Parameters

orgID
string
required
Pattern: ^org_[a-z2-7]{26}$
projectID
string
required
Pattern: ^proj_[a-z2-7]{26}$
agentID
string
required
Pattern: ^agt_[a-z2-7]{26}$

Query Parameters

after_sequence
integer<int64>
Required range: x >= 0
stream_deltas
boolean

Opt in to ephemeral delta streamed frames while a model call is in flight. This includes partial assistant text, tool call, and reasoning output. Each frame carries the public turn_id and model_call_context_id it belongs to, and tool_use block starts carry the same public tool_call_id the durable model_output content block and tool_result event will use. Deltas are best-effort: they are not persisted and are not replayed on reconnect. The durable model_output event remains the source of truth. Default false.

Response

Server-sent event stream. Durable frames use agent_input, model_output, tool_result, or context_checkpoint as the SSE event name and set the SSE id field to the event's sequence, which reconnects can replay via Last-Event-ID. Best-effort tool lifecycle updates use tool_call_update, model previews use model_output_delta, and terminal stream errors use error; none carries an SSE id, so reconnects resume from the last durable event. Heartbeats are SSE comments and carry no JSON payload.

One JSON payload from the event stream: an authoritative durable event, a best-effort tool-call update, a best-effort model-output preview, or a terminal stream error.

id
string
required
Pattern: ^evt_[a-z2-7]{26}$
org_id
string
required
Pattern: ^org_[a-z2-7]{26}$
project_id
string
required
Pattern: ^proj_[a-z2-7]{26}$
agent_id
string
required
Pattern: ^agt_[a-z2-7]{26}$
turn_id
string
required
Pattern: ^trn_[a-z2-7]{26}$
turn_sequence
integer
required

Positive per-agent event, turn, or live-frame sequence.

Required range: 1 <= x <= 9007199254740991
is_opening_event
boolean
required
sequence
integer
required

Positive per-agent event, turn, or live-frame sequence.

Required range: 1 <= x <= 9007199254740991
event_kind
enum<string>
required
Available options:
agent_input
agent_input_id
string
required

Matches the input that produced this event, allowing clients to correlate an input submission with its durable timeline admission.

Pattern: ^ain_[a-z2-7]{26}$
input_kind
enum<string>
required
Available options:
content,
control,
interaction_response,
config_change
content_blocks
object[]
required
created_at
string<date-time>
required
actor_id
string

Actor attributed to the input. Resolve details through the project actors endpoints.

Pattern: ^actr_[a-z2-7]{26}$
input_idempotency_key
string

Echoes the Idempotency-Key of a content-input request so its sender can recognize the durable admission. Absent for other input kinds.

control_type
enum<string>
Available options:
cancel_current
interaction_id
string

Interaction answered by an interaction_response input.

Pattern: ^int_[a-z2-7]{26}$
agent_config_id
string

Configuration selected by a config_change input.

Pattern: ^acfg_[a-z2-7]{26}$