agent-runs

Create Agent Run

post/v2/agents

Request body

promptstring required

request_idstring nullable

Idempotency key; two runs with one request_id start one fire.

timezonestring

user_idstring nullable

Run-as user for org-level (sk_) API keys, which carry no user context of their own. Ignored for OAuth callers: their token identifies the user.

Successful Response

task_idstring required

Opaque agent run identifier.

request_idstring required

statusstring required