---
title: "Changes to Create completion"
method: POST
path: "/completions"
---

# Changes to Create completion

`POST /completions`

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 16 of 164 revisions.

- **2026-09-25** `d86203de41ae` — 5 info
- **2026-09-03** `9430b00d75b4` — 2 info
- **2026-09-03** `5f6acbcbb919` — 1 info
- **2026-09-01** `ca86486f9fef` — 1 warning
- **2026-08-27** `60c5936f2a2f` — 1 info
- **2026-08-14** `6ac2618eefd7` — 1 info
- **2026-08-14** `fe3335711e48` — 3 info
- **2026-08-05** `ab0c5306e390` — 1 info
- **2026-05-13** `74cbcf73838f` — 3 breaking, 5 warning, 2 info
- **2025-02-04** `5c0e3ef6b492` — 9 info
- **2025-01-21** `47138a7dd8b9` — 1 breaking
- **2025-01-21** `0d83ef8a5f65` — 2 warning, 1 info
- **2025-01-17** `88f3bede7665` — 1 breaking
- **2024-11-04** `681d8ec16477` — 2 info
- **2024-10-17** `cc9f99ba40bc` — 2 info
- **2024-09-13** `4c9e3967c707` — 1 info

## Changes

- **2026-09-25** `d86203de41ae` — 5 info
  - added the non-success response with the status `400`
  - added the non-success response with the status `401`
  - added the non-success response with the status `403`
  - added the non-success response with the status `404`
  - added the non-success response with the status `500`
- **2026-09-03** `9430b00d75b4` — 2 info
  - added the optional property `error/misalignment` to the response with the `429` status
  - added the optional property `error/misalignment` to the response with the `503` status
- **2026-09-03** `5f6acbcbb919` — 1 info
  - added the non-success response with the status `503`
- **2026-09-01** `ca86486f9fef` — 1 warning
  - removed the optional property `usage/compute_units` from the response with the `200` status
- **2026-08-27** `60c5936f2a2f` — 1 info
  - added the optional property `usage/compute_units` to the response with the `200` status
- **2026-08-14** `6ac2618eefd7` — 1 info
  - added the non-success response with the status `429`
- **2026-08-14** `fe3335711e48` — 3 info
  - added the optional property `usage/completion_tokens_details/text_tokens` to the response with the `200` status
  - added the optional property `usage/prompt_tokens_details/image_tokens` to the response with the `200` status
  - added the optional property `usage/prompt_tokens_details/text_tokens` to the response with the `200` status
- **2026-08-05** `ab0c5306e390` — 1 info
  - added the optional property `usage/prompt_tokens_details/cache_write_tokens` to the response with the `200` status
- **2026-05-13** `74cbcf73838f` — 3 breaking, 5 warning, 2 info
  - the request property `stream_options` became not nullable
  - the `stream_options` request property type changed from `object` to no type
  - the `choices/items/logprobs` response's property type changed from `object` to no type for status `200`
  - removed the request property `stream_options/include_usage`
  - removed the optional property `choices/items/logprobs/text_offset` from the response with the `200` status
  - removed the optional property `choices/items/logprobs/token_logprobs` from the response with the `200` status
  - removed the optional property `choices/items/logprobs/tokens` from the response with the `200` status
  - removed the optional property `choices/items/logprobs/top_logprobs` from the response with the `200` status
  - added `subschema #1, subschema #2` to the `stream_options` request property `anyOf` list
  - added `subschema #1, subschema #2` to the `choices/items/logprobs` response property `anyOf` list for the response status `200`
- **2025-02-04** `5c0e3ef6b492` — 9 info
  - the `accepted_prediction_tokens` response's property default value `0` was added for the status `200`
  - the `audio_tokens` response's property default value `0` was added for the status `200`
  - the `audio_tokens` response's property default value `0` was added for the status `200`
  - the `cached_tokens` response's property default value `0` was added for the status `200`
  - the `completion_tokens` response's property default value `0` was added for the status `200`
  - the `prompt_tokens` response's property default value `0` was added for the status `200`
  - the `reasoning_tokens` response's property default value `0` was added for the status `200`
  - the `rejected_prediction_tokens` response's property default value `0` was added for the status `200`
  - the `total_tokens` response's property default value `0` was added for the status `200`
- **2025-01-21** `47138a7dd8b9` — 1 breaking
  - the `seed` request property format changed from no format to `int64`
- **2025-01-21** `0d83ef8a5f65` — 2 warning, 1 info
  - the `seed` request property's max was set to `9223372036854775808.00`
  - the `seed` request property's min was set to `-9223372036854775808.00`
  - the `seed` request property format was generalized from `int64` to no format
- **2025-01-17** `88f3bede7665` — 1 breaking
  - the `seed` request property format changed from no format to `int64`
- **2024-11-04** `681d8ec16477` — 2 info
  - added the optional property `usage/completion_tokens_details/accepted_prediction_tokens` to the response with the `200` status
  - added the optional property `usage/completion_tokens_details/rejected_prediction_tokens` to the response with the `200` status
- **2024-10-17** `cc9f99ba40bc` — 2 info
  - added the optional property `usage/completion_tokens_details/audio_tokens` to the response with the `200` status
  - added the optional property `usage/prompt_tokens_details` to the response with the `200` status
- **2024-09-13** `4c9e3967c707` — 1 info
  - added the optional property `usage/completion_tokens_details` to the response with the `200` status

---

[Operation](https://skmtc.dev/openai/apis/openapi/docs/completions/post.md) · [API](https://skmtc.dev/openai/apis/openapi.md) · [Page](https://skmtc.dev/openai/apis/openapi/changes/completions/post)