Sign in
Batch

Delete a batch

Deletes a batch in a terminal status (completed, failed, expired, or cancelled) and its stored requests and results. Batches still in progress return 409. Billing and usage records are kept. See the Batch API Quickstart.

delete/batches/{id}

Path parameters

idstring required

The batch job id returned from submit.

Example:batch_abc123

The batch job id returned from submit.

Response

The batch was deleted; per-target outcomes are reported under deletion.

idstring required
object'batch' required

Example response

{
  "deletion": {
    "openrouter": "deleted",
    "upstream": {
      "provider": "OpenAI",
      "status": "unsupported"
    }
  },
  "id": "batch_abc123",
  "object": "batch"
}

Changes

Changed in 1 of the 303 revisions of this API.1