---
title: "Changes to Create items"
method: POST
path: "/conversations/{conversation_id}/items"
---

# Changes to Create items

`POST /conversations/{conversation_id}/items`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 9 of 88 revisions.

- **2026-10-26** `410e6429083a`: 19 info
- **2026-10-23** `af780af62f70`: 4 info
- **2026-10-20** `fbe6e5768509`: 3 info
- **2026-10-15** `12b3c184a924`: 2 breaking, 2 info
- **2026-10-13** `ec8179625cd5`: 2 info
- **2026-10-06** `ae9945cbda0f`: 1 breaking, 1 info
- **2026-10-06** `487892d3954e`: 4 info
- **2026-10-05** `6ff85664169c`: 1 breaking
- **2026-10-05** `7f654af7f94f`: 1 info

## Changes

- **2026-10-26** `410e6429083a`: 19 info
  - added the new optional request property `items/items/oneOf[subschema #1: Input message]/content/oneOf[subschema #2: Input item content list]/items/oneOf[subschema #1: Input text]/prompt_cache_breakpoint/ttl`
  - added the new optional request property `items/items/oneOf[subschema #1: Input message]/content/oneOf[subschema #2: Input item content list]/items/oneOf[subschema #2: Input image]/prompt_cache_breakpoint/ttl`
  - added the new optional request property `items/items/oneOf[subschema #1: Input message]/content/oneOf[subschema #2: Input item content list]/items/oneOf[subschema #3: Input file]/prompt_cache_breakpoint/ttl`
  - added the new optional request property `items/items/oneOf[subschema #2: Item]/oneOf[subschema #1: Input message]/content/items/oneOf[subschema #1: Input text]/prompt_cache_breakpoint/ttl`
  - added the new optional request property `items/items/oneOf[subschema #2: Item]/oneOf[subschema #1: Input message]/content/items/oneOf[subschema #2: Input image]/prompt_cache_breakpoint/ttl`
  - added the new optional request property `items/items/oneOf[subschema #2: Item]/oneOf[subschema #1: Input message]/content/items/oneOf[subschema #3: Input file]/prompt_cache_breakpoint/ttl`
  - added the new optional request property `items/items/oneOf[subschema #2: Item]/oneOf[subschema #27: Custom tool call output]/output/oneOf[subschema #2: output content list]/items/oneOf[subschema #1: Input text]/prompt_cache_breakpoint/ttl`
  - added the new optional request property `items/items/oneOf[subschema #2: Item]/oneOf[subschema #27: Custom tool call output]/output/oneOf[subschema #2: output content list]/items/oneOf[subschema #2: Input image]/prompt_cache_breakpoint/ttl`
  - added the new optional request property `items/items/oneOf[subschema #2: Item]/oneOf[subschema #27: Custom tool call output]/output/oneOf[subschema #2: output content list]/items/oneOf[subschema #3: Input file]/prompt_cache_breakpoint/ttl`
  - added the optional property `data/items/oneOf[#/components/schemas/FunctionToolCallOutputResource]/allOf[subschema #1: Function tool call output]/output/oneOf[subschema #2: output content list]/items/oneOf[subschema #1: Input text]/prompt_cache_breakpoint/ttl` to the response with the `200` status
  - added the optional property `data/items/oneOf[#/components/schemas/FunctionToolCallOutputResource]/allOf[subschema #1: Function tool call output]/output/oneOf[subschema #2: output content list]/items/oneOf[subschema #2: Input image]/prompt_cache_breakpoint/ttl` to the response with the `200` status
  - added the optional property `data/items/oneOf[#/components/schemas/FunctionToolCallOutputResource]/allOf[subschema #1: Function tool call output]/output/oneOf[subschema #2: output content list]/items/oneOf[subschema #3: Input file]/prompt_cache_breakpoint/ttl` to the response with the `200` status
  - added the optional property `data/items/oneOf[subschema #1: Message]/content/items/oneOf[subschema #1: Input text]/prompt_cache_breakpoint/ttl` to the response with the `200` status
  - added the optional property `data/items/oneOf[subschema #1: Message]/content/items/oneOf[subschema #7: Input image]/prompt_cache_breakpoint/ttl` to the response with the `200` status
  - added the optional property `data/items/oneOf[subschema #1: Message]/content/items/oneOf[subschema #8: Computer screenshot]/prompt_cache_breakpoint/ttl` to the response with the `200` status
  - added the optional property `data/items/oneOf[subschema #1: Message]/content/items/oneOf[subschema #9: Input file]/prompt_cache_breakpoint/ttl` to the response with the `200` status
  - added the optional property `data/items/oneOf[subschema #29: Custom tool call output]/output/oneOf[subschema #2: output content list]/items/oneOf[subschema #1: Input text]/prompt_cache_breakpoint/ttl` to the response with the `200` status
  - added the optional property `data/items/oneOf[subschema #29: Custom tool call output]/output/oneOf[subschema #2: output content list]/items/oneOf[subschema #2: Input image]/prompt_cache_breakpoint/ttl` to the response with the `200` status
  - added the optional property `data/items/oneOf[subschema #29: Custom tool call output]/output/oneOf[subschema #2: output content list]/items/oneOf[subschema #3: Input file]/prompt_cache_breakpoint/ttl` to the response with the `200` status
- **2026-10-23** `af780af62f70`: 4 info
  - the `` request property default value changed from `gpt-image-1` to `gpt-image-2`
  - the `` request property default value changed from `gpt-image-1` to `gpt-image-2`
  - the `` response's property default value changed from `gpt-image-1` to `gpt-image-2` for the status `200`
  - the `` response's property default value changed from `gpt-image-1` to `gpt-image-2` for the status `200`
- **2026-10-20** `fbe6e5768509`: 3 info
  - added the new optional request property `items/items/oneOf[subschema #2: Item]/oneOf[subschema #8: Function tool call output]/output/oneOf[subschema #2]/items/oneOf[subschema #1: Input text]/prompt_cache_breakpoint/anyOf[subschema #1: Prompt cache breakpoint]/ttl`
  - added the new optional request property `items/items/oneOf[subschema #2: Item]/oneOf[subschema #8: Function tool call output]/output/oneOf[subschema #2]/items/oneOf[subschema #2: Input image]/prompt_cache_breakpoint/anyOf[subschema #1: Prompt cache breakpoint]/ttl`
  - added the new optional request property `items/items/oneOf[subschema #2: Item]/oneOf[subschema #8: Function tool call output]/output/oneOf[subschema #2]/items/oneOf[subschema #3: Input file]/prompt_cache_breakpoint/anyOf[subschema #1: Prompt cache breakpoint]/ttl`
- **2026-10-15** `12b3c184a924`: 2 breaking, 2 info
  - the response property `data/items/oneOf[subschema #5: Web search tool call]/action/oneOf[subschema #3: Find action]/url` became optional for the status `200`
  - response property `data/items/oneOf[subschema #5: Web search tool call]/action/oneOf[subschema #3: Find action]/url` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - the request property `items/items/oneOf[subschema #2: Item]/oneOf[subschema #6: Web search tool call]/action/oneOf[subschema #3: Find action]/url` became optional
  - request property `items/items/oneOf[subschema #2: Item]/oneOf[subschema #6: Web search tool call]/action/oneOf[subschema #3: Find action]/url` list-of-types was widened by adding types `null` to media type `application/json`
- **2026-10-13** `ec8179625cd5`: 2 info
  - added the new optional request property `items/items/oneOf[subschema #2: Item]/oneOf[subschema #15: Image generation call]/error`
  - added the optional property `data/items/oneOf[subschema #6: Image generation call]/error` to the response with the `200` status
- **2026-10-06** `ae9945cbda0f`: 1 breaking, 1 info
  - removed `#/components/schemas/NamespaceToolParam` from the `items/items/oneOf[subschema #2: Item]/oneOf[#/components/schemas/ToolSearchOutputItemParam]/tools/items/` request property `oneOf` list
  - added `#/components/schemas/ToolSearchOutputNamespaceToolParam` to the `items/items/oneOf[subschema #2: Item]/oneOf[#/components/schemas/ToolSearchOutputItemParam]/tools/items/` request property `oneOf` list
- **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 `429` status
  - added the optional property `error/misalignment/review_target` to the response with the `500` status
- **2026-10-05** `6ff85664169c`: 1 breaking
  - removed the required property `data/items/oneOf[#/components/schemas/ComputerToolCallOutputResource]/allOf[subschema #2]/id` from the response with the `200` status
- **2026-10-05** `7f654af7f94f`: 1 info
  - endpoint added

---

[Operation](https://skmtc.dev/omnistack-sh/apis/openai-api/docs/conversations/:conversation_id/items/post.md) - [API](https://skmtc.dev/omnistack-sh/apis/openai-api.md) - [Page](https://skmtc.dev/omnistack-sh/apis/openai-api/changes/conversations/:conversation_id/items/post)
