Stream events
Authorizations
An opaque Omnara personal or organization bearer token.
Headers
x >= 0Path Parameters
^org_[a-z2-7]{26}$^proj_[a-z2-7]{26}$^agt_[a-z2-7]{26}$Query Parameters
x >= 0Opt 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.
- Option 1
- Option 2
- Option 3
- Option 4
- Option 5
- Option 6
- Option 7
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.
^evt_[a-z2-7]{26}$^org_[a-z2-7]{26}$^proj_[a-z2-7]{26}$^agt_[a-z2-7]{26}$^trn_[a-z2-7]{26}$Positive per-agent event, turn, or live-frame sequence.
1 <= x <= 9007199254740991Positive per-agent event, turn, or live-frame sequence.
1 <= x <= 9007199254740991agent_input Matches the input that produced this event, allowing clients to correlate an input submission with its durable timeline admission.
^ain_[a-z2-7]{26}$content, control, interaction_response, config_change - Option 1
- Option 2
Actor attributed to the input. Resolve details through the project actors endpoints.
^actr_[a-z2-7]{26}$Echoes the Idempotency-Key of a content-input request so its sender can recognize the durable admission. Absent for other input kinds.
cancel_current Interaction answered by an interaction_response input.
^int_[a-z2-7]{26}$Configuration selected by a config_change input.
^acfg_[a-z2-7]{26}$