Skip to main content
POST
Start Run

Authorizations

Authorization
string
header
required

API key authentication. Get your API key from the Duvo dashboard.

Path Parameters

teamId
string
required

Body

application/json
agent_id
string<uuid>
required

The agent ID to run

message
string

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

sandbox_id
string

Optional sandbox ID with pre-uploaded files

webhook_url
string<uri>

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

Response

Default Response

run
object
required

The newly created run