v106

OpenAPI 3.1.0raw.githubusercontent.com2026-08-02160524464.6 KB

Runs

Delete Runs

Deletes up to 250 runs in one fail-soft, non-transactional request. Each run is processed independently. A valid batch returns 200 even when some items fail; inspect results and summary for per-run outcomes. Invalid request bodies are rejected before mutating any run.

post/api/v1/runs/delete

Request body

run_idsstring[] required

Run IDs to process, in result order.

forceboolean

Whether to force deletion of active runs. Defaults to false.

Example request

{
  "run_ids": [
    "01HZX6M29F1CD5YYMHT1F5D7WQ"
  ]
}

Response

Batch processed

Example response

{
  "results": [
    {
      "error": {
        "status": "404",
        "title": "Not Found",
        "detail": "Run not found.",
        "code": "access_token_expired"
      }
    }
  ]
}