Run an agent
API Reference
Run an agent
Runs a persisted agent and streams AG-UI events (text/event-stream). Tools, MCP servers, knowledge bases, and the system prompt come from the stored agent. A tools array on this request does not add capabilities. state may override max_steps and compress_context for this run only. Nested model calls use /v1/chat/completions. See Agents.
POST
Run an agent
Path Parameters
Agent id from the dashboard, for example agt_....
Body
application/json
AG-UI run input. Field names are camelCase on the wire.
Response
AG-UI Server-Sent Events. Event types include RUN_STARTED, TEXT_MESSAGE_CONTENT, TOOL_CALL_START, TOOL_CALL_RESULT, RUN_FINISHED, and RUN_ERROR.
The response is of type string.

