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

# Changes to Create Completion

`POST /v1/completions`

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 7 of 9 revisions.

- **2024-08-30** `790b47aba5c5` — 4 breaking, 3 warning, 3 info
- **2024-06-28** `370f4057658e` — 1 info
- **2024-06-05** `f36bd8f8ff45` — 1 breaking, 2 info
- **2024-06-05** `53428307b5b7` — 2 breaking, 1 warning
- **2024-06-05** `f36bd8f8ff45` — 1 breaking, 2 info
- **2024-05-21** `53428307b5b7` — 11 breaking, 17 warning, 7 info
- **2024-05-01** `151d12519cac` — 1 breaking, 1 warning, 5 info

## Changes

- **2024-08-30** `790b47aba5c5` — 4 breaking, 3 warning, 3 info
  - added `#/components/schemas/StreamOptions` to the `stream_options` request property `allOf` list
  - removed `#/components/schemas/StreamOptions, subschema #2` from the `stream_options` request property `anyOf` list
  - the `object` response's property type changed from no type to `string` for status `200` (media type: application/json)
  - the `object` response's property type changed from no type to `string` for status `500`
  - added the new `error` enum value to the `object` response property for the response status `500`
  - added the new `text_completion` enum value to the `object` response property for the response status `200` (media type: application/json)
  - added the new `text_completion` enum value to the `object` response property for the response status `200` (media type: text/event-stream)
  - added the new optional request property `log_prompt`
  - added the new optional request property `min_p`
  - the `max_tokens` request property default value changed from `16` to `512`
- **2024-06-28** `370f4057658e` — 1 info
  - added the new optional request property `peft`
- **2024-06-05** `f36bd8f8ff45` — 1 breaking, 2 info
  - the `object` response's property type changed from `string` to no type for status `500`
  - added the new optional request property `ignore_eos`
  - the `object` response property const value `error` was added for the status `500`
- **2024-06-05** `53428307b5b7` — 2 breaking, 1 warning
  - the `object` response property const value `error` was removed for the status `500`
  - the `object` response's property type changed from no type to `string` for status `500`
  - removed the request property `ignore_eos`
- **2024-06-05** `f36bd8f8ff45` — 1 breaking, 2 info
  - the `object` response's property type changed from `string` to no type for status `500`
  - added the new optional request property `ignore_eos`
  - the `object` response property const value `error` was added for the status `500`
- **2024-05-21** `53428307b5b7` — 11 breaking, 17 warning, 7 info
  - request property `best_of` list-of-types was narrowed by removing types `null` from media type `application/json`
  - request property `echo` list-of-types was narrowed by removing types `null` from media type `application/json`
  - request property `frequency_penalty` list-of-types was narrowed by removing types `null` from media type `application/json`
  - request property `max_tokens` list-of-types was narrowed by removing types `null` from media type `application/json`
  - request property `n` list-of-types was narrowed by removing types `null` from media type `application/json`
  - request property `presence_penalty` list-of-types was narrowed by removing types `null` from media type `application/json`
  - request property `repetition_penalty` list-of-types was narrowed by removing types `null` from media type `application/json`
  - request property `seed` list-of-types was narrowed by removing types `null` from media type `application/json`
  - request property `stream` list-of-types was narrowed by removing types `null` from media type `application/json`
  - request property `temperature` list-of-types was narrowed by removing types `null` from media type `application/json`
  - request property `top_p` list-of-types was narrowed by removing types `null` from media type `application/json`
  - the `repetition_penalty` request property's exclusiveMinimum was set to `0.00`
  - the `top_p` request property's exclusiveMinimum was set to `0.00`
  - the `frequency_penalty` request property's max was set to `2.00`
  - the `logprobs/anyOf[subschema #1]/` request property's max was set to `5.00`
  - the `presence_penalty` request property's max was set to `2.00`
  - the `temperature` request property's max was set to `2.00`
  - the `top_p` request property's max was set to `1.00`
  - the `frequency_penalty` request property's min was set to `-2.00`
  - the `logprobs/anyOf[subschema #1]/` request property's min was set to `0.00`
  - the `max_tokens` request property's min was set to `1.00`
  - the `n` request property's min was set to `1.00`
  - the `presence_penalty` request property's min was set to `-2.00`
  - the `temperature` request property's min was set to `0.00`
  - added the new `cancelled` enum value to the `choices/items/finish_reason/anyOf[subschema #1: FinishReason]/` response property for the response status `200` (media type: application/json)
  - added the new `cancelled` enum value to the `choices/items/finish_reason/anyOf[subschema #1: FinishReason]/` response property for the response status `200` (media type: text/event-stream)
  - added the new `tool_calls` enum value to the `choices/items/finish_reason/anyOf[subschema #1: FinishReason]/` response property for the response status `200` (media type: application/json)
  - added the new `tool_calls` enum value to the `choices/items/finish_reason/anyOf[subschema #1: FinishReason]/` response property for the response status `200` (media type: text/event-stream)
  - added the new optional request property `loglikelihood`
  - added the new optional request property `stream_options`
  - request property `prompt` list-of-types was widened by adding types `null` to media type `application/json`
  - added `#/components/schemas/Logprobs` to the `choices/items/logprobs` response property `anyOf` list for the response status `200` (media type: application/json)
  - added `#/components/schemas/Logprobs` to the `choices/items/logprobs` response property `anyOf` list for the response status `200` (media type: text/event-stream)
  - removed `#/components/schemas/LogProbs` from the `choices/items/logprobs` response property `anyOf` list for the response status `200` (media type: application/json)
  - removed `#/components/schemas/LogProbs` from the `choices/items/logprobs` response property `anyOf` list for the response status `200` (media type: text/event-stream)
- **2024-05-01** `151d12519cac` — 1 breaking, 1 warning, 5 info
  - the `object` response's property type changed from `string` to no type for status `200`
  - the `max_tokens/anyOf[subschema #1]/` request property's min was set to `1.00`
  - added the media type `text/event-stream` for the response with the status `200`
  - added the non-success response with the status `500`
  - added `#/components/schemas/FinishReason` to the `choices/items/finish_reason` response property `anyOf` list for the response status `200`
  - removed `subschema #1` from the `choices/items/finish_reason` response property `anyOf` list for the response status `200`
  - the `object` response property const value `text_completion` was added for the status `200`

---

[Operation](https://skmtc.dev/octoml/apis/ollm-api/docs/v1/completions/post.md) · [API](https://skmtc.dev/octoml/apis/ollm-api.md) · [Page](https://skmtc.dev/octoml/apis/ollm-api/changes/v1/completions/post)