Sign in

v1

latestOpenAPI 3.1.0Apache 2.0raw.githubusercontent.com2026-05-044743166.6 KB
tasks

Batch trigger a specific task

Batch trigger a specific task with up to 1,000 payloads. All items in the batch run the same task.

post/api/v1/tasks/{taskIdentifier}/batch

Request body

Example request

{
  "items": [
    {
      "options": {
        "tags": "user_123456",
        "machine": "small-2x"
      }
    }
  ]
}

Response

Batch triggered successfully

batchIdstring required

The ID of the batch that was triggered

runsstring[] required

An array of run IDs that were triggered

Example response

{
  "batchId": "batch_1234"
}