POST
Run Task Batch

Authorizations

Authorization
string
header
required

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

Body

application/json
runs
RunItem · object[]
required
Required array length: 1 - 1000 elements
task
TaskConfig · object | null

A complete task definition, run and stored nowhere else.

task_id
string<uuid> | null

A task in this workspace. Exclusive with task.

task_override
TaskPatch · object | null

Changes for this run only: objects deep-merge, lists replace, null clears.

task_version

Which version of task_id to run. Omit for the published one; "draft" runs the unpublished config, held to the publish checks.

Response

Successful Response

runs
TaskRunBatchItem · object[]
required