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

# Cancel a batch

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

## Request

- Base URL: `https://api.cohere.com`
- URL: `https://api.cohere.com/v2/batches/{id}:cancel`
- Auth: HTTP bearer

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

---

[API](https://skmtc.dev/cohere-ai/apis/cohere-api.md) · [All operations](https://skmtc.dev/cohere-ai/apis/cohere-api/llms.txt) · [OpenAPI document](https://skmtc.dev/cohere-ai/apis/cohere-api/revisions/8e538a293bd3?raw)