Runs

Start Run

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

post/v2/teams/{teamId}/runs

Request

Path parameters

teamIdstring required

Request body

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)

Response

Default Response

Changes

No recorded changes to this operation across all 1 revision of this API.