POST
Run Task

Authorizations

Authorization
string
header
required

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

Path Parameters

task_id
string<uuid>
required

Body

application/json
vars
Vars · object

Values for the variables this task declares, by name. A required variable with no value and no default is refused before the run starts; a name the task does not declare is refused too, rather than silently dropped.

Response

Successful Response

attempts
integer
default:0
required
billing_status
string
default:pending
required
duration_ms
integer | null
required
ended_at
string<date-time> | null
required
error
TaskRunError · object | null
required
id
string<uuid>
required
max_steps
integer
default:0
required
output
Output · object | null
required
provider_cost
number | null
required
started_at
string<date-time>
required
status
enum<string>
required
Available options:
running,
completed,
failed
steps_used
integer
default:0
required
task_id
string<uuid> | null
required
task_name
string | null
required
trace
TraceStepResponse · object[]
required
usage
LLMUsage · object[]
required
vars
Vars · object
required