Sign in

v1

latestOpenAPI 3.0.02026-07-26300209.6 KB
Runs

Cancel multiple runs by IDs

Cancel multiple runs by their IDs in a single request. Returns per-run results including cancelled runs, already-terminal runs, and not-found IDs. Maximum 100 IDs per request. Idempotent: calling twice returns consistent results.

post/v1/runs/batch/cancel

Request body

run_idsstring[] required

Array of run IDs (1-100)

Example request

{
  "run_ids": [
    "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "b2c3d4e5-f6a7-8901-bcde-f23456789012"
  ]
}

Response

Request succeeded. Returns per-run results in results and any missing IDs in not_found.

not_foundstring[] nullable required

Run IDs that were not found or not owned. Null if all found.

Example response

{
  "results": [
    {
      "run_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "status": "CANCELLED",
      "cancelled_at": "2026-01-14T10:30:55Z",
      "message": "Run already cancelled"
    }
  ]
}