v68

latestOpenAPI 3.0.0raw.githubusercontent.com2026-08-0189430445.4 KB
Agents

Create an agent run and stream the response

Executes an agent run and returns the result as a stream of server-sent events (SSE). Note: If the agent uses an input form trigger, all form fields (including optional fields) must be included in the input object.

post/rest/api/v1/agents/runs/stream

Request body

agent_idstring required

The ID of the agent to run.

inputobject

The input to the agent. Required when the agent uses an input form trigger.

metadataobject

The metadata to pass to the agent.

Example request

{
  "messages": [
    {
      "role": "USER"
    }
  ]
}

Response

Success