---
title: "Changes to Retrieve an item"
method: GET
path: "/conversations/{conversation_id}/items/{item_id}"
---

# Changes to Retrieve an item

`GET /conversations/{conversation_id}/items/{item_id}`

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 16 of 164 revisions.

- **2026-09-25** `d86203de41ae` — 1 info
- **2026-09-16** `2cd8933757a4` — 2 info
- **2026-09-10** `2f07cb0091b4` — 6 info
- **2026-09-08** `6bfa47154802` — 2 info
- **2026-09-08** `185927e212ab` — 12 warning
- **2026-09-04** `d3d980dbba53` — 1 warning
- **2026-09-03** `9430b00d75b4` — 1 breaking, 11 info
- **2026-08-29** `959ef977e135` — 1 warning
- **2026-08-28** `5c81016c9be7` — 1 info
- **2026-08-20** `5de4ab93fa24` — 4 warning
- **2026-08-14** `19962d085c85` — 1 info
- **2026-08-14** `6ac2618eefd7` — 1 info
- **2026-08-14** `fe3335711e48` — 1 info
- **2026-08-13** `fc45a2f64c0a` — 2 info
- **2026-08-05** `ab0c5306e390` — 5 breaking, 3 warning, 32 info
- **2026-05-13** `74cbcf73838f` — 1 info

## Changes

- **2026-09-25** `d86203de41ae` — 1 info
  - added the non-success response with the status `404`
- **2026-09-16** `2cd8933757a4` — 2 info
  - response property `oneOf[#/components/schemas/AdditionalTools]/tools/items/oneOf[subschema #6: MCP tool]/connector_id` deprecated
  - response property `oneOf[#/components/schemas/ToolSearchOutput]/tools/items/oneOf[subschema #6: MCP tool]/connector_id` deprecated
- **2026-09-10** `2f07cb0091b4` — 6 info
  - added the optional property `oneOf[subschema #6: Image generation call]/action` to the response with the `200` status
  - added the optional property `oneOf[subschema #6: Image generation call]/background` to the response with the `200` status
  - added the optional property `oneOf[subschema #6: Image generation call]/output_format` to the response with the `200` status
  - added the optional property `oneOf[subschema #6: Image generation call]/revised_prompt` to the response with the `200` status
  - added `subschema #1` to the `oneOf[subschema #6: Image generation call]/size` response property `anyOf` list for the response status `200`
  - removed `subschema #1, subschema #2` from the `oneOf[subschema #6: Image generation call]/size` response property `anyOf` list for the response status `200`
- **2026-09-08** `6bfa47154802` — 2 info
  - added the optional property `oneOf[subschema #6: Image generation call]/quality` to the response with the `200` status
  - added the optional property `oneOf[subschema #6: Image generation call]/size` to the response with the `200` status
- **2026-09-08** `185927e212ab` — 12 warning
  - added the new `gpt-image-2.5-flare` enum value to the `oneOf[#/components/schemas/AdditionalTools]/tools/items/oneOf[subschema #9: Image generation tool]/model/anyOf[subschema #2]/` response property for the response status `200`
  - added the new `gpt-image-2.5-flare` enum value to the `oneOf[#/components/schemas/ToolSearchOutput]/tools/items/oneOf[subschema #9: Image generation tool]/model/anyOf[subschema #2]/` response property for the response status `200`
  - added the new `gpt-image-2.5-flare-2026-09-08` enum value to the `oneOf[#/components/schemas/AdditionalTools]/tools/items/oneOf[subschema #9: Image generation tool]/model/anyOf[subschema #2]/` response property for the response status `200`
  - added the new `gpt-image-2.5-flare-2026-09-08` enum value to the `oneOf[#/components/schemas/ToolSearchOutput]/tools/items/oneOf[subschema #9: Image generation tool]/model/anyOf[subschema #2]/` response property for the response status `200`
  - added the new `gpt-image-2.5-sunburst` enum value to the `oneOf[#/components/schemas/AdditionalTools]/tools/items/oneOf[subschema #9: Image generation tool]/model/anyOf[subschema #2]/` response property for the response status `200`
  - added the new `gpt-image-2.5-sunburst` enum value to the `oneOf[#/components/schemas/ToolSearchOutput]/tools/items/oneOf[subschema #9: Image generation tool]/model/anyOf[subschema #2]/` response property for the response status `200`
  - added the new `gpt-image-2.5-sunburst-2026-09-08` enum value to the `oneOf[#/components/schemas/AdditionalTools]/tools/items/oneOf[subschema #9: Image generation tool]/model/anyOf[subschema #2]/` response property for the response status `200`
  - added the new `gpt-image-2.5-sunburst-2026-09-08` enum value to the `oneOf[#/components/schemas/ToolSearchOutput]/tools/items/oneOf[subschema #9: Image generation tool]/model/anyOf[subschema #2]/` response property for the response status `200`
  - added the new `max` enum value to the `oneOf[#/components/schemas/AdditionalTools]/tools/items/oneOf[subschema #9: Image generation tool]/quality` response property for the response status `200`
  - added the new `max` enum value to the `oneOf[#/components/schemas/ToolSearchOutput]/tools/items/oneOf[subschema #9: Image generation tool]/quality` response property for the response status `200`
  - added the new `xhigh` enum value to the `oneOf[#/components/schemas/AdditionalTools]/tools/items/oneOf[subschema #9: Image generation tool]/quality` response property for the response status `200`
  - added the new `xhigh` enum value to the `oneOf[#/components/schemas/ToolSearchOutput]/tools/items/oneOf[subschema #9: Image generation tool]/quality` response property for the response status `200`
- **2026-09-04** `d3d980dbba53` — 1 warning
  - added the new `incomplete` enum value to the `oneOf[subschema #5: Web search tool call]/status` response property for the response status `200`
- **2026-09-03** `9430b00d75b4` — 1 breaking, 11 info
  - added `#/components/schemas/ResponseConfigurationUpdate` to the response body `oneOf` list for the response status `200`
  - added the optional property `error/misalignment` to the response with the `429` status
  - added the optional property `oneOf[#/components/schemas/AdditionalTools]/tools/items/oneOf[subschema #12: Custom tool]/async` to the response with the `200` status
  - added the optional property `oneOf[#/components/schemas/AdditionalTools]/tools/items/oneOf[subschema #13: Namespace]/tools/items/oneOf[#/components/schemas/FunctionToolParam]/async` to the response with the `200` status
  - added the optional property `oneOf[#/components/schemas/AdditionalTools]/tools/items/oneOf[subschema #13: Namespace]/tools/items/oneOf[subschema #2: Custom tool]/async` to the response with the `200` status
  - added the optional property `oneOf[#/components/schemas/AdditionalTools]/tools/items/oneOf[subschema #1: Function]/async` to the response with the `200` status
  - added the optional property `oneOf[#/components/schemas/FunctionToolCallResource]/allOf[subschema #1: Function tool call]/async` to the response with the `200` status
  - added the optional property `oneOf[#/components/schemas/ToolSearchOutput]/tools/items/oneOf[subschema #12: Custom tool]/async` to the response with the `200` status
  - added the optional property `oneOf[#/components/schemas/ToolSearchOutput]/tools/items/oneOf[subschema #13: Namespace]/tools/items/oneOf[#/components/schemas/FunctionToolParam]/async` to the response with the `200` status
  - added the optional property `oneOf[#/components/schemas/ToolSearchOutput]/tools/items/oneOf[subschema #13: Namespace]/tools/items/oneOf[subschema #2: Custom tool]/async` to the response with the `200` status
  - added the optional property `oneOf[#/components/schemas/ToolSearchOutput]/tools/items/oneOf[subschema #1: Function]/async` to the response with the `200` status
  - added the optional property `oneOf[subschema #27: Custom tool call -> subschema #28: Custom tool call]/async` to the response with the `200` status
- **2026-08-29** `959ef977e135` — 1 warning
  - removed the optional property `oneOf[#/components/schemas/AdditionalTools]/prompt_cache_breakpoint` from the response with the `200` status
- **2026-08-28** `5c81016c9be7` — 1 info
  - added the optional property `oneOf[#/components/schemas/AdditionalTools]/prompt_cache_breakpoint` to the response with the `200` status
- **2026-08-20** `5de4ab93fa24` — 4 warning
  - added the new `gpt-image-2` enum value to the `oneOf[#/components/schemas/AdditionalTools]/tools/items/oneOf[subschema #9: Image generation tool]/model/anyOf[subschema #2]/` response property for the response status `200`
  - added the new `gpt-image-2` enum value to the `oneOf[#/components/schemas/ToolSearchOutput]/tools/items/oneOf[subschema #9: Image generation tool]/model/anyOf[subschema #2]/` response property for the response status `200`
  - added the new `gpt-image-2-2026-04-21` enum value to the `oneOf[#/components/schemas/AdditionalTools]/tools/items/oneOf[subschema #9: Image generation tool]/model/anyOf[subschema #2]/` response property for the response status `200`
  - added the new `gpt-image-2-2026-04-21` enum value to the `oneOf[#/components/schemas/ToolSearchOutput]/tools/items/oneOf[subschema #9: Image generation tool]/model/anyOf[subschema #2]/` response property for the response status `200`
- **2026-08-14** `19962d085c85` — 1 info
  - removed `subschema #1` from the `oneOf[subschema #26: MCP tool call]/error` response property `anyOf` list for the response status `200`
- **2026-08-14** `6ac2618eefd7` — 1 info
  - added the non-success response with the status `429`
- **2026-08-14** `fe3335711e48` — 1 info
  - added `#/components/schemas/MCPToolCallError` to the `oneOf[subschema #26: MCP tool call]/error` response property `anyOf` list for the response status `200`
- **2026-08-13** `fc45a2f64c0a` — 2 info
  - added the optional property `oneOf[#/components/schemas/AdditionalTools]/tools/items/oneOf[subschema #5: Web search]/external_web_access` to the response with the `200` status
  - added the optional property `oneOf[#/components/schemas/ToolSearchOutput]/tools/items/oneOf[subschema #5: Web search]/external_web_access` to the response with the `200` status
- **2026-08-05** `ab0c5306e390` — 5 breaking, 3 warning, 32 info
  - added `#/components/schemas/AdditionalTools, #/components/schemas/Program, #/components/schemas/ProgramOutput` to the response body `oneOf` list for the response status `200`
  - the response property `oneOf[#/components/schemas/FunctionToolCallOutputResource]/allOf[subschema #1: Function tool call output]/call_id` became optional for the status `200`
  - the response property `oneOf[subschema #5: Web search tool call]/action/oneOf[subschema #1: Search action]/query` became optional for the status `200`
  - the `oneOf[#/components/schemas/ToolSearchOutput]/tools/items/oneOf[subschema #12: Namespace -> subschema #13: Namespace]/description` response property's minLength was decreased from `1` to `0` for the response status `200`
  - added `#/components/schemas/ProgrammaticToolCallingParam` to the `oneOf[#/components/schemas/ToolSearchOutput]/tools/items/` response property `oneOf` list for the response status `200`
  - added the new `auto` enum value to the `oneOf[#/components/schemas/FunctionToolCallOutputResource]/allOf[subschema #1: Function tool call output]/output/oneOf[subschema #2: output content list]/items/oneOf[subschema #3: Input file]/detail` response property for the response status `200`
  - added the new `auto` enum value to the `oneOf[subschema #1: Message]/content/items/oneOf[subschema #9: Input file]/detail` response property for the response status `200`
  - added the new `auto` enum value to the `oneOf[subschema #25: Custom tool call output -> subschema #28: Custom tool call output]/output/oneOf[subschema #2: output content list]/items/oneOf[subschema #3: Input file]/detail` response property for the response status `200`
  - added the optional property `oneOf[#/components/schemas/FunctionToolCallOutputResource]/allOf[subschema #1: Function tool call output]/caller` to the response with the `200` status
  - added the optional property `oneOf[#/components/schemas/FunctionToolCallOutputResource]/allOf[subschema #1: Function tool call output]/name` to the response with the `200` status
  - added the optional property `oneOf[#/components/schemas/FunctionToolCallOutputResource]/allOf[subschema #1: Function tool call output]/namespace` to the response with the `200` status
  - added the optional property `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` to the response with the `200` status
  - added the optional property `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` to the response with the `200` status
  - added the optional property `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` to the response with the `200` status
  - added the optional property `oneOf[#/components/schemas/FunctionToolCallResource]/allOf[subschema #1: Function tool call]/caller` to the response with the `200` status
  - added the optional property `oneOf[#/components/schemas/ToolSearchOutput]/tools/items/oneOf[subschema #10: Shell tool -> subschema #11: Shell tool]/allowed_callers` to the response with the `200` status
  - added the optional property `oneOf[#/components/schemas/ToolSearchOutput]/tools/items/oneOf[subschema #11: Custom tool -> subschema #12: Custom tool]/allowed_callers` to the response with the `200` status
  - added the optional property `oneOf[#/components/schemas/ToolSearchOutput]/tools/items/oneOf[subschema #12: Namespace -> subschema #13: Namespace]/tools/items/oneOf[#/components/schemas/FunctionToolParam]/allowed_callers` to the response with the `200` status
  - added the optional property `oneOf[#/components/schemas/ToolSearchOutput]/tools/items/oneOf[subschema #12: Namespace -> subschema #13: Namespace]/tools/items/oneOf[#/components/schemas/FunctionToolParam]/output_schema` to the response with the `200` status
  - added the optional property `oneOf[#/components/schemas/ToolSearchOutput]/tools/items/oneOf[subschema #12: Namespace -> subschema #13: Namespace]/tools/items/oneOf[subschema #2: Custom tool]/allowed_callers` to the response with the `200` status
  - added the optional property `oneOf[#/components/schemas/ToolSearchOutput]/tools/items/oneOf[subschema #15: Apply patch tool -> subschema #16: Apply patch tool]/allowed_callers` to the response with the `200` status
  - added the optional property `oneOf[#/components/schemas/ToolSearchOutput]/tools/items/oneOf[subschema #1: Function]/allowed_callers` to the response with the `200` status
  - added the optional property `oneOf[#/components/schemas/ToolSearchOutput]/tools/items/oneOf[subschema #1: Function]/output_schema` to the response with the `200` status
  - added the optional property `oneOf[#/components/schemas/ToolSearchOutput]/tools/items/oneOf[subschema #6: MCP tool]/allowed_callers` to the response with the `200` status
  - added the optional property `oneOf[#/components/schemas/ToolSearchOutput]/tools/items/oneOf[subschema #6: MCP tool]/tunnel_id` to the response with the `200` status
  - added the optional property `oneOf[#/components/schemas/ToolSearchOutput]/tools/items/oneOf[subschema #7: Code interpreter]/allowed_callers` to the response with the `200` status
  - added the optional property `oneOf[subschema #16: Shell tool call -> subschema #19: Shell tool call]/caller` to the response with the `200` status
  - added the optional property `oneOf[subschema #17: Shell call output -> subschema #20: Shell call output]/caller` to the response with the `200` status
  - added the optional property `oneOf[subschema #18: Apply patch tool call -> subschema #21: Apply patch tool call]/caller` to the response with the `200` status
  - added the optional property `oneOf[subschema #19: Apply patch tool call output -> subschema #22: Apply patch tool call output]/caller` to the response with the `200` status
  - added the optional property `oneOf[subschema #1: Message]/content/items/oneOf[subschema #1: Input text]/prompt_cache_breakpoint` to the response with the `200` status
  - added the optional property `oneOf[subschema #1: Message]/content/items/oneOf[subschema #7: Input image]/prompt_cache_breakpoint` to the response with the `200` status
  - added the optional property `oneOf[subschema #1: Message]/content/items/oneOf[subschema #8: Computer screenshot]/prompt_cache_breakpoint` to the response with the `200` status
  - added the optional property `oneOf[subschema #1: Message]/content/items/oneOf[subschema #9: Input file]/prompt_cache_breakpoint` to the response with the `200` status
  - added the optional property `oneOf[subschema #24: Custom tool call -> subschema #27: Custom tool call]/caller` to the response with the `200` status
  - added the optional property `oneOf[subschema #25: Custom tool call output -> subschema #28: Custom tool call output]/caller` to the response with the `200` status
  - added the optional property `oneOf[subschema #25: Custom tool call output -> subschema #28: Custom tool call output]/output/oneOf[subschema #2: output content list]/items/oneOf[subschema #1: Input text]/prompt_cache_breakpoint` to the response with the `200` status
  - added the optional property `oneOf[subschema #25: Custom tool call output -> subschema #28: Custom tool call output]/output/oneOf[subschema #2: output content list]/items/oneOf[subschema #2: Input image]/prompt_cache_breakpoint` to the response with the `200` status
  - added the optional property `oneOf[subschema #25: Custom tool call output -> subschema #28: Custom tool call output]/output/oneOf[subschema #2: output content list]/items/oneOf[subschema #3: Input file]/prompt_cache_breakpoint` to the response with the `200` status
  - response property `oneOf[subschema #5: Web search tool call]/action/oneOf[subschema #1: Search action]/query` deprecated
- **2026-05-13** `74cbcf73838f` — 1 info
  - endpoint added

---

[Operation](https://skmtc.dev/openai/apis/openapi/docs/conversations/:conversation_id/items/:item_id/get.md) · [API](https://skmtc.dev/openai/apis/openapi.md) · [Page](https://skmtc.dev/openai/apis/openapi/changes/conversations/:conversation_id/items/:item_id/get)