---
title: "Delete a batch"
method: DELETE
path: "/batches/{id}"
tags: ["Batches"]
---

# Delete a batch

`DELETE /batches/{id}`

Soft-delete a batch in a terminal status.

## Path parameters

- `id` string, required — Batch ID.

## Headers

- `Exa-Beta` 'batches-2026-06-06', required — Required beta token for the Batch API.

## Response `200`

OK

- DeletedBatch
  - `id` string, required — ID of the deleted batch.
  - `object` 'batch.deleted', required — The object type, always `batch.deleted`.
  - `deleted` true, required — Always `true` for a successful delete.

## Other responses

- `400` — The request body or query parameters failed validation.
- `401` — The API key is missing or invalid.
- `404` — The requested resource does not exist.
- `409` — The request conflicts with the current state of the resource.
- `500` — An unexpected error occurred while processing the request.

## Changes

- **2026-08-27** `67abccbd77b6` — 1 warning, 4 info
  - deleted the `header` request parameter `Exa-Version`
  - added the non-success response with the status `400`
  - added the non-success response with the status `404`
  - added the non-success response with the status `409`
  - …1 more
- **2026-08-26** `bcc51991b48a` — 1 info
  - added the new optional `header` request parameter `Exa-Version`
- **2026-08-25** `659cf16a7325` — 1 info
  - added the non-success response with the status `401`
- **2026-08-24** `cebbdd9640af` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/exa/apis/exa-public-api/changes/batches/:id/delete.md)

---

[API](https://skmtc.dev/exa/apis/exa-public-api.md) · [All operations](https://skmtc.dev/exa/apis/exa-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/exa/exa-public-api/revisions/67abccbd77b6/schema)