Delete a batch

Delete a batch in a terminal status.

DELETE /batches/{id}

Delete a batch

cURL

curl --request DELETE \
  --url https://api.exa.ai/batches/{id} \
  --header 'Exa-Beta: <exa-beta>' \
  --header 'x-api-key: <api-key>'

200

{
  "id": "batch_01j7x9v0m2n4p6q8r0s2t4v6w8",
  "object": "batch.deleted",
  "deleted": true
}

Deleting a batch removes it from your team’s batch history. Only batches in a terminal status can be deleted.

Get your Exa API key

Authorizations

apiKeybearer

x-api-key · string · header · required

Pass your Exa API key in the x-api-key header. You can also authenticate with Authorization: Bearer .

Headers

Exa-Beta · enum<string> · required

Required beta token for the Batch API.

Available options: batches-2026-06-06

Path Parameters

id · string · required

Batch ID.

Minimum string length: 1

Example:

"batch_01j7x9v0m2n4p6q8r0s2t4v6w8"

Response

200

application/json

OK

id · string · required

ID of the deleted batch.

object · string · required

The object type, always batch.deleted.

Allowed value: "batch.deleted"

deleted · boolean · required

Always true for a successful delete.