{
  "detail": "Bad request",
  "error_code": "BAD_REQUEST"
}

Agents

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

{
  "detail": "Bad request",
  "error_code": "BAD_REQUEST"
}

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

agent_id

string

required

multipart/form-data

message

string

required

stream

boolean

default:false

session_id

string | null

user_id

string | null

files

file[] | null

Agent run executed successfully

⌘I