Skip to main content
POST
/
agent
/
{agent_id}
/
run
Run Agent
curl --request POST \
  --url https://api.example.com/agent/{agent_id}/run
Runs the agent with the given input and returns a Server-Sent Events stream.

​
Path Parameters

ParameterTypeDescription
agent_idstringThe agent’s unique identifier

​
Request Body

{
  "message": "Summarize our Q4 sales data",
  "conversation_id": "conv_abc123",
  "verbose": true
}
FieldTypeRequiredDescription
messagestringyesThe user’s input
conversation_idstringnoContinue an existing conversation
verboseboolnoInclude nested tool/sub-agent events

​
Response (SSE Stream)

data: {"type": "START", "call_id": "call_1", "metadata": {"display_name": "MainAgent"}}

data: {"type": "DELTA", "delta": "Based on the Q4 data", "call_id": "call_1"}

data: {"type": "DELTA", "delta": ", total revenue was...", "call_id": "call_1"}

data: {"type": "END", "delta": "Based on the Q4 data, total revenue was...", "call_id": "call_1"}