---
title: "Changes to Cancel batch"
method: POST
path: "/batches/{batch_id}/cancel"
---

# Changes to Cancel batch

`POST /batches/{batch_id}/cancel`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 6 of 397 revisions.

- **2026-10-06** `e2f8d8cbc41f`: 4 info
- **2026-09-28** `1c308918d47e`: 6 breaking
- **2026-09-28** `3829daed1d44`: 5 breaking
- **2026-09-25** `b6ca60f934e8`: 4 info
- **2026-05-13** `74cbcf73838f`: 3 breaking, 2 info
- **2026-04-10** `7c540cce6eb3`: 3 breaking, 2 info

## Changes

- **2026-10-06** `e2f8d8cbc41f`: 4 info
  - added the optional property `error/misalignment/review_target` to the response with the `400` status
  - added the optional property `error/misalignment/review_target` to the response with the `404` status
  - added the optional property `error/misalignment/review_target` to the response with the `409` status
  - added the optional property `error/misalignment/review_target` to the response with the `429` status
- **2026-09-28** `1c308918d47e`: 6 breaking
  - the response property `completed_at` became nullable for the status `200`
  - the response property `error_file_id` became nullable for the status `200`
  - the response property `expires_at` became nullable for the status `200`
  - the response property `finalizing_at` became nullable for the status `200`
  - the response property `in_progress_at` became nullable for the status `200`
  - the response property `output_file_id` became nullable for the status `200`
- **2026-09-28** `3829daed1d44`: 5 breaking
  - the response property `cancelled_at` became nullable for the status `200`
  - the response property `cancelling_at` became nullable for the status `200`
  - the response property `errors` became nullable for the status `200`
  - the response property `expired_at` became nullable for the status `200`
  - the response property `failed_at` became nullable for the status `200`
- **2026-09-25** `b6ca60f934e8`: 4 info
  - 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`
  - added the non-success response with the status `429`
- **2026-05-13** `74cbcf73838f`: 3 breaking, 2 info
  - response property `errors/data/items/line` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `errors/data/items/param` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `metadata` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - added the optional property `model` to the response with the `200` status
  - added the optional property `usage` to the response with the `200` status
- **2026-04-10** `7c540cce6eb3`: 3 breaking, 2 info
  - response property `errors/data/items/line` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `errors/data/items/param` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `metadata` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - added the optional property `model` to the response with the `200` status
  - added the optional property `usage` to the response with the `200` status

---

[Operation](https://skmtc.dev/openai/apis/openapi/docs/batches/:batch_id/cancel/post.md) - [API](https://skmtc.dev/openai/apis/openapi.md) - [Page](https://skmtc.dev/openai/apis/openapi/changes/batches/:batch_id/cancel/post)
