---
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 2 of 88 revisions.

- **2026-10-06** `487892d3954e`: 4 info
- **2026-10-05** `7f654af7f94f`: 22 breaking, 6 info

## Changes

- **2026-10-06** `487892d3954e`: 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-10-05** `7f654af7f94f`: 22 breaking, 6 info
  - 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 `completed_at` became nullable for the status `200`
  - the response property `error_file_id` 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 `expires_at` became nullable for the status `200`
  - the response property `failed_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`
  - 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`
  - the `cancelled_at` response's property type changed from `integer` to `integer, null`, and format from no format to `unixtime` for status `200`
  - the `cancelling_at` response's property type changed from `integer` to `integer, null`, and format from no format to `unixtime` for status `200`
  - the `completed_at` response's property type changed from `integer` to `integer, null`, and format from no format to `unixtime` for status `200`
  - the `expired_at` response's property type changed from `integer` to `integer, null`, and format from no format to `unixtime` for status `200`
  - the `expires_at` response's property type changed from `integer` to `integer, null`, and format from no format to `unixtime` for status `200`
  - the `failed_at` response's property type changed from `integer` to `integer, null`, and format from no format to `unixtime` for status `200`
  - the `finalizing_at` response's property type changed from `integer` to `integer, null`, and format from no format to `unixtime` for status `200`
  - the `in_progress_at` response's property type changed from `integer` to `integer, null`, and format from no format to `unixtime` for status `200`
  - 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`
  - 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/omnistack-sh/apis/openai-api/docs/batches/:batch_id/cancel/post.md) - [API](https://skmtc.dev/omnistack-sh/apis/openai-api.md) - [Page](https://skmtc.dev/omnistack-sh/apis/openai-api/changes/batches/:batch_id/cancel/post)
