---
title: "Delete batch"
method: DELETE
path: "/v2/batches/{batch_id}"
tags: ["batches"]
---

# Delete batch

`DELETE /v2/batches/{batch_id}`

Delete a batch and all its files. This is an asynchronous operation that must be [checked for completion](/api-sdk/api-reference/batches/poll-batches-job).

## Path parameters

- `batch_id` integer, required

## Headers

- `Authorization` string, required
- `IB-Context` string

## Response `202`

Batch deletion request accepted. [Poll the job ID](/api-sdk/api-reference/batches/poll-batches-job) to check completion status.

- BatchDeletionJobResponse
  - `job_id` string, required — The job ID of the operation. Use the job ID with the [Poll batches job endpoint](/api-sdk/api-reference/batches/poll-batches-job) to check batch deletion status.

## Other responses

- `404` — Batch does not exist.

---

[API](https://skmtc.net/instabase/apis/api-reference.md) · [All operations](https://skmtc.net/instabase/apis/api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/instabase/api-reference/revisions/3a4f46d48141/schema)