---
title: "Changes to Creates and executes a batch from an uploaded file of requests.\r\nResponse includes details of the enqueued job including job status.\r\nThe ID of the result file is added to the response once complete."
method: POST
path: "/batches"
---

# Changes to Creates and executes a batch from an uploaded file of requests.
Response includes details of the enqueued job including job status.
The ID of the result file is added to the response once complete.

`POST /batches`

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 5 of 26 revisions.

- **2026-07-13** (2022-03-01-preview) `b177dc430e39` — 1 breaking, 2 info
- **2026-07-13** (2022-03-01-preview) `5a7369607eb2` — 1 breaking, 1 info
- **2026-07-13** (2022-03-01-preview) `7f597b88d2e9` — 1 breaking, 1 info
- **2026-07-13** (2022-03-01-preview) `086f672d3648` — 1 info
- **2022-07-22** (2022-03-01-preview) `9d525b5caa31` — 1 breaking

## Changes

- **2026-07-13** (2022-03-01-preview) `b177dc430e39` — 1 breaking, 2 info
  - added required request body
  - added the media type `application/json` for the response with the status `201`
  - added the media type `application/json` for the response with the status `default`
- **2026-07-13** (2022-03-01-preview) `5a7369607eb2` — 1 breaking, 1 info
  - removed the success response with the status `201`
  - added the success response with the status `200`
- **2026-07-13** (2022-03-01-preview) `7f597b88d2e9` — 1 breaking, 1 info
  - removed the success response with the status `200`
  - added the success response with the status `201`
- **2026-07-13** (2022-03-01-preview) `086f672d3648` — 1 info
  - endpoint added
- **2022-07-22** (2022-03-01-preview) `9d525b5caa31` — 1 breaking
  - api path removed without deprecation

---

[Operation](https://skmtc.dev/azure/apis/cognitiveservices-azureopenai-authoring/docs/batches/post.md) · [API](https://skmtc.dev/azure/apis/cognitiveservices-azureopenai-authoring.md) · [Page](https://skmtc.dev/azure/apis/cognitiveservices-azureopenai-authoring/changes/batches/post)