v1
latestOpenAPI 3.1.02026-07-26142186376.1 KBAgents
Create Agent Run
Execute an agent with a message and optional media files. Supports both streaming and non-streaming responses.
Features:
- Text message input with optional session management
- Multi-media support: images (PNG, JPEG, WebP), audio (WAV, MP3), video (MP4, WebM, etc.)
- Document processing: PDF, CSV, DOCX, TXT, JSON
- Real-time streaming responses with Server-Sent Events (SSE)
- User and session context preservation
Streaming Response: When stream=true, returns SSE events with event and data fields.
post/agents/{agent_id}/runs
Path parameters
agent_idstring required
Response
Agent run executed successfully
{"stackTrail":"paths:/agents/{agent_id}/runs:post:responses:200:content:application/json:schema","oasType":"schema","type":"unknown"}