--- title: "Changes to Create a batch" method: POST path: "/api/v1/batches" --- # Changes to Create a batch `POST /api/v1/batches` > Every recorded change to this operation, newest first. ## Timeline Changed in 6 of 19 revisions. - **2026-10-21** `c30bcb383ee8`: 12 breaking, 4 info - **2026-10-02** `b830b79cfd52`: 3 warning, 2 info - **2026-09-17** `6fa8242da8c2`: 1 warning, 1 info - **2026-09-12** `22b868ef3f22`: 1 info - **2026-08-13** `4e064cf81dae`: 24 info - **2026-07-31** `c26d550029f8`: 3 breaking, 19 warning, 2 info ## Changes - **2026-10-21** `c30bcb383ee8`: 12 breaking, 4 info - request body became required - 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` - api operation id `openAiBatch_createBatch` removed and replaced with `createBatch` - api tag `OpenAI Batch` added - api tag `openAiBatch` removed - removed `subschema #1, subschema #2` from the `errors` response property `oneOf` list for the response status `200` - **2026-10-02** `b830b79cfd52`: 3 warning, 2 info - removed the optional property `error` from the response with the `401` status - removed the optional property `error_class` from the response with the `401` status - removed the optional property `id` from the response with the `401` status - added the non-success response with the status `403` - the response property `detail` became required for the status `401` - **2026-09-17** `6fa8242da8c2`: 1 warning, 1 info - deleted the `header` request parameter `Authorization` - the endpoint scheme security `RespanApiKey` was added to the API - **2026-09-12** `22b868ef3f22`: 1 info - api operation id `create-batch` removed and replaced with `openAiBatch_createBatch` - **2026-08-13** `4e064cf81dae`: 24 info - added the new optional `header` request parameter `X-Data-Respan-Params` - added optional request body - added the non-success response with the status `400` - added the non-success response with the status `401` - added the optional property `cancelled_at` to the response with the `200` status - added the optional property `cancelling_at` to the response with the `200` status - added the optional property `completed_at` to the response with the `200` status - added the optional property `completion_window` to the response with the `200` status - added the optional property `created_at` to the response with the `200` status - added the optional property `endpoint` to the response with the `200` status - added the optional property `error_file_id` to the response with the `200` status - added the optional property `errors` to the response with the `200` status - added the optional property `expired_at` to the response with the `200` status - added the optional property `expires_at` to the response with the `200` status - added the optional property `failed_at` to the response with the `200` status - added the optional property `finalizing_at` to the response with the `200` status - added the optional property `in_progress_at` to the response with the `200` status - added the optional property `input_file_id` to the response with the `200` status - added the optional property `metadata` to the response with the `200` status - added the optional property `object` to the response with the `200` status - added the optional property `output_file_id` to the response with the `200` status - added the optional property `request_counts` to the response with the `200` status - added the required property `id` to the response with the `200` status - added the required property `status` to the response with the `200` status - **2026-07-31** `c26d550029f8`: 3 breaking, 19 warning, 2 info - removed the request body - removed the required property `id` from the response with the `200` status - removed the required property `status` from the response with the `200` status - deleted the `header` request parameter `X-Data-Respan-Params` - removed the optional property `cancelled_at` from the response with the `200` status - removed the optional property `cancelling_at` from the response with the `200` status - removed the optional property `completed_at` from the response with the `200` status - removed the optional property `completion_window` from the response with the `200` status - removed the optional property `created_at` from the response with the `200` status - removed the optional property `endpoint` from the response with the `200` status - removed the optional property `error_file_id` from the response with the `200` status - removed the optional property `errors` from the response with the `200` status - removed the optional property `expired_at` from the response with the `200` status - removed the optional property `expires_at` from the response with the `200` status - removed the optional property `failed_at` from the response with the `200` status - removed the optional property `finalizing_at` from the response with the `200` status - removed the optional property `in_progress_at` from the response with the `200` status - removed the optional property `input_file_id` from the response with the `200` status - removed the optional property `metadata` from the response with the `200` status - removed the optional property `object` from the response with the `200` status - removed the optional property `output_file_id` from the response with the `200` status - removed the optional property `request_counts` from the response with the `200` status - removed the non-success response with the status `400` - removed the non-success response with the status `401` --- [Operation](https://skmtc.dev/keywordsai/apis/respan-api/docs/api/v1/batches/post.md) - [API](https://skmtc.dev/keywordsai/apis/respan-api.md) - [Page](https://skmtc.dev/keywordsai/apis/respan-api/changes/api/v1/batches/post)