v1

latestOpenAPI 3.0.32026-07-222111928.0 KB

Runs

Start Run

Start a new agent run. Returns immediately with run info - does not wait for completion.

post/v2/teams/{teamId}/runs

teamIdstring required

agent_idstring uuid required

The agent ID to run

messagestring

Optional initial message to start the run with (e.g. a trigger payload or user instruction)

sandbox_idstring

Optional sandbox ID with pre-uploaded files

webhook_urlstring uri

Webhook URL to POST events to (human_request, run_completed, run_failed, run_interrupted)

Default Response