---
title: "Cancel a batch"
method: POST
path: "/v2/batches/{id}:cancel"
tags: ["/batches"]
---

# Cancel a batch

`POST /v2/batches/{id}:cancel`

Cancels an in-progress batch

## Path parameters

- `id` string, required

## Headers

- `X-Client-Name` string

## Response `200`

A successful response.

- CancelBatchResponse — Response to a request to cancel a batch.

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `500` — Internal Server Error
- `503` — Status Service Unavailable

## Changes

> 58 revisions in range; 2 could not be searched.

- **2025-10-15** `8363f0437ae8` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/cohere-ai/apis/api-reference/changes/v2/batches/:id:cancel/post.md)

---

[API](https://skmtc.dev/cohere-ai/apis/api-reference.md) · [All operations](https://skmtc.dev/cohere-ai/apis/api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/cohere-ai/api-reference/revisions/6f64ec87c66d/schema)