Sign in

v1

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

Batch trigger tasks

Batch trigger tasks with up to 1,000 payloads with SDK 4.3.1+ (500 in prior versions).

post/api/v1/tasks/batch

Request body

Example request

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

Response

Task 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"
}