Run Gateway Turn (Stream)
Run a gateway turn and stream every event over SSE.
TaskUpdateEvent over Server-Sent Events. This is the fast-time-to-first-token path: a connected event flushes immediately, then the router starts answering before any heavy downstream work begins.
Pass id = your conversation_id to start or continue a conversation; omit it to start a new one. Sub-execution events (the downstream agents the router dispatches) are forwarded onto the same stream.
Use the sub_tasks query parameter to force how the router dispatches downstream work: sync runs every sub-execution in the foreground (the turn waits for each child, like the email trigger), async pushes every sub-execution to the background (results are pushed back to the conversation later), and auto restores the computed per-task decision. This is separate from whether this API call blocks, and the mode sticks to the conversation until changed.
See the Agent Gateway overview for the event model and how sub-executions stream back.Authorizations
API Key for authentication
Path Parameters
Query Parameters
Agent version to run.
Force how the gateway dispatches downstream sub-tasks inside this run (not whether this API call blocks): 'sync' runs every sub-task inline, 'async' queues every sub-task, 'auto' restores the computed per-sub-task decision. The mode sticks to the conversation until changed.
sync, async, auto Body
text, markdown, json, voice default, harder Per-execution override for the LLM provider (e.g. 'openai', 'anthropic'). Falls back to the agent's configured provider when unset.
Per-execution override for the LLM model name. Falls back to the agent's configured model when unset.
Per-execution override for reasoning effort on reasoning-capable models.
low, medium, high, xhigh Surface that created this execution (mirrored to AgentExecutionHistory.source_node_type). Falls back to SourceNodeType.SDK at persist time when unset.
workbench, sdk, task, assistant, webhook, mcp, a2a, telegram, slack, email, api Forces gateway sub-task dispatch: 'sync' runs all downstream sub-tasks inline, 'async' queues them all, 'auto' restores the computed per-sub-task decision.
sync, async, auto Response
Successful Response

