Sign in
Conversations

Retrieve an item

Get a single item from a conversation with the given IDs.

get/conversations/{conversation_id}/items/{item_id}

Path parameters

conversation_idstring required
Example:conv_123

The ID of the conversation that contains the item.

item_idstring required
Example:msg_abc

The ID of the item to retrieve.

Query parameters

includeIncludeEnum[]

Additional fields to include in the response. See the include parameter for listing Conversation items above for more information.

Response

OK

OR
OR
OR
OR
OR
OR
OR
OR
OR
OR
OR
OR
OR
OR
OR
OR
OR
OR
OR
OR
OR
OR
OR
OR
OR
OR
OR

Changes

Changed in 5 of the 31 revisions of this API.2650

  • e0508a503b84341See the full diff
    • ●

      added the new auto enum value to the anyOf[FunctionToolCallOutputResource]/allOf[subschema #1: Function tool call output]/output/anyOf[subschema #2: output content list]/items/anyOf[subschema #3: Input file]/detail response property for the response status 200

      response-property-enum-value-added

    • ●

      added the new auto enum value to the anyOf[subschema #1: Message]/content/items/anyOf[subschema #9: Input file]/detail response property for the response status 200

      response-property-enum-value-added

    • ●

      added the new auto enum value to the anyOf[subschema #26: Custom tool call output -> subschema #28: Custom tool call output]/output/anyOf[subschema #2: output content list]/items/anyOf[subschema #3: Input file]/detail response property for the response status 200

      response-property-enum-value-added

    • ○

      added Program ProgramOutput to the response body anyOf list for the response status 200

      response-body-any-of-added

    • ○

      added the optional property anyOf[AdditionalTools]/tools/items/anyOf[subschema #10: Shell tool -> subschema #11: Shell tool]/allowed_callers to the response with the 200 status

      response-optional-property-added

    • ○

      added the optional property anyOf[AdditionalTools]/tools/items/anyOf[subschema #11: Custom tool -> subschema #12: Custom tool]/allowed_callers to the response with the 200 status

      response-optional-property-added

    • ○

      added the optional property anyOf[AdditionalTools]/tools/items/anyOf[subschema #12: Namespace -> subschema #13: Namespace]/tools/items/anyOf[FunctionToolParam]/allowed_callers to the response with the 200 status

      response-optional-property-added

    • ○

      added the optional property anyOf[AdditionalTools]/tools/items/anyOf[subschema #12: Namespace -> subschema #13: Namespace]/tools/items/anyOf[FunctionToolParam]/output_schema to the response with the 200 status

      response-optional-property-added

    • ○

      added the optional property anyOf[AdditionalTools]/tools/items/anyOf[subschema #12: Namespace -> subschema #13: Namespace]/tools/items/anyOf[subschema #2: Custom tool]/allowed_callers to the response with the 200 status

      response-optional-property-added

    • ○

      added the optional property anyOf[AdditionalTools]/tools/items/anyOf[subschema #15: Apply patch tool -> subschema #16: Apply patch tool]/allowed_callers to the response with the 200 status

      response-optional-property-added

    • ○

      added the optional property anyOf[AdditionalTools]/tools/items/anyOf[subschema #1: Function]/allowed_callers to the response with the 200 status

      response-optional-property-added

    • ○

      added the optional property anyOf[AdditionalTools]/tools/items/anyOf[subschema #1: Function]/output_schema to the response with the 200 status

      response-optional-property-added

    • ○

      added the optional property anyOf[AdditionalTools]/tools/items/anyOf[subschema #6: MCP tool]/allowed_callers to the response with the 200 status

      response-optional-property-added

    • ○

      added the optional property anyOf[AdditionalTools]/tools/items/anyOf[subschema #7: Code interpreter]/allowed_callers to the response with the 200 status

      response-optional-property-added

    • ○

      added the optional property anyOf[FunctionToolCallOutputResource]/allOf[subschema #1: Function tool call output]/caller to the response with the 200 status

      response-optional-property-added

    • ○

      added the optional property anyOf[FunctionToolCallOutputResource]/allOf[subschema #1: Function tool call output]/output/anyOf[subschema #2: output content list]/items/anyOf[subschema #1: Input text]/prompt_cache_breakpoint to the response with the 200 status

      response-optional-property-added

    • ○

      added the optional property anyOf[FunctionToolCallOutputResource]/allOf[subschema #1: Function tool call output]/output/anyOf[subschema #2: output content list]/items/anyOf[subschema #2: Input image]/prompt_cache_breakpoint to the response with the 200 status

      response-optional-property-added

    • ○

      added the optional property anyOf[FunctionToolCallOutputResource]/allOf[subschema #1: Function tool call output]/output/anyOf[subschema #2: output content list]/items/anyOf[subschema #3: Input file]/prompt_cache_breakpoint to the response with the 200 status

      response-optional-property-added

    • ○

      added the optional property anyOf[FunctionToolCallResource]/allOf[subschema #1: Function tool call]/caller to the response with the 200 status

      response-optional-property-added

    • ○

      added the optional property anyOf[ToolSearchOutput]/tools/items/anyOf[subschema #10: Shell tool -> subschema #11: Shell tool]/allowed_callers to the response with the 200 status

      response-optional-property-added

    • ○

      added the optional property anyOf[ToolSearchOutput]/tools/items/anyOf[subschema #11: Custom tool -> subschema #12: Custom tool]/allowed_callers to the response with the 200 status

      response-optional-property-added

    • ○

      added the optional property anyOf[ToolSearchOutput]/tools/items/anyOf[subschema #12: Namespace -> subschema #13: Namespace]/tools/items/anyOf[FunctionToolParam]/allowed_callers to the response with the 200 status

      response-optional-property-added

    • ○

      added the optional property anyOf[ToolSearchOutput]/tools/items/anyOf[subschema #12: Namespace -> subschema #13: Namespace]/tools/items/anyOf[FunctionToolParam]/output_schema to the response with the 200 status

      response-optional-property-added

    • ○

      added the optional property anyOf[ToolSearchOutput]/tools/items/anyOf[subschema #12: Namespace -> subschema #13: Namespace]/tools/items/anyOf[subschema #2: Custom tool]/allowed_callers to the response with the 200 status

      response-optional-property-added

    • ○

      added the optional property anyOf[ToolSearchOutput]/tools/items/anyOf[subschema #15: Apply patch tool -> subschema #16: Apply patch tool]/allowed_callers to the response with the 200 status

      response-optional-property-added

    • ○

      added the optional property anyOf[ToolSearchOutput]/tools/items/anyOf[subschema #1: Function]/allowed_callers to the response with the 200 status

      response-optional-property-added

    • ○

      added the optional property anyOf[ToolSearchOutput]/tools/items/anyOf[subschema #1: Function]/output_schema to the response with the 200 status

      response-optional-property-added

    • ○

      added the optional property anyOf[ToolSearchOutput]/tools/items/anyOf[subschema #6: MCP tool]/allowed_callers to the response with the 200 status

      response-optional-property-added

    • ○

      added the optional property anyOf[ToolSearchOutput]/tools/items/anyOf[subschema #7: Code interpreter]/allowed_callers to the response with the 200 status

      response-optional-property-added

    • ○

      added the optional property anyOf[subschema #17: Shell tool call -> subschema #19: Shell tool call]/caller to the response with the 200 status

      response-optional-property-added

    • ○

      added the optional property anyOf[subschema #18: Shell call output -> subschema #20: Shell call output]/caller to the response with the 200 status

      response-optional-property-added

    • ○

      added the optional property anyOf[subschema #19: Apply patch tool call -> subschema #21: Apply patch tool call]/caller to the response with the 200 status

      response-optional-property-added

    • ○

      added the optional property anyOf[subschema #1: Message]/content/items/anyOf[subschema #1: Input text]/prompt_cache_breakpoint to the response with the 200 status

      response-optional-property-added

    • ○

      added the optional property anyOf[subschema #1: Message]/content/items/anyOf[subschema #7: Input image]/prompt_cache_breakpoint to the response with the 200 status

      response-optional-property-added

    • ○

      added the optional property anyOf[subschema #1: Message]/content/items/anyOf[subschema #8: Computer screenshot]/prompt_cache_breakpoint to the response with the 200 status

      response-optional-property-added

    • ○

      added the optional property anyOf[subschema #1: Message]/content/items/anyOf[subschema #9: Input file]/prompt_cache_breakpoint to the response with the 200 status

      response-optional-property-added

    • ○

      added the optional property anyOf[subschema #20: Apply patch tool call output -> subschema #22: Apply patch tool call output]/caller to the response with the 200 status

      response-optional-property-added

    • ○

      added the optional property anyOf[subschema #25: Custom tool call -> subschema #27: Custom tool call]/caller to the response with the 200 status

      response-optional-property-added

    • ○

      added the optional property anyOf[subschema #26: Custom tool call output -> subschema #28: Custom tool call output]/caller to the response with the 200 status

      response-optional-property-added

    • ○

      added the optional property anyOf[subschema #26: Custom tool call output -> subschema #28: Custom tool call output]/output/anyOf[subschema #2: output content list]/items/anyOf[subschema #1: Input text]/prompt_cache_breakpoint to the response with the 200 status

      response-optional-property-added

    • ○

      added the optional property anyOf[subschema #26: Custom tool call output -> subschema #28: Custom tool call output]/output/anyOf[subschema #2: output content list]/items/anyOf[subschema #2: Input image]/prompt_cache_breakpoint to the response with the 200 status

      response-optional-property-added

    • ○

      added the optional property anyOf[subschema #26: Custom tool call output -> subschema #28: Custom tool call output]/output/anyOf[subschema #2: output content list]/items/anyOf[subschema #3: Input file]/prompt_cache_breakpoint to the response with the 200 status

      response-optional-property-added

    • ○

      added ProgrammaticToolCallingParam to the anyOf[AdditionalTools]/tools/items/ response property anyOf list for the response status 200

      response-property-any-of-added

    • ○

      added ProgrammaticToolCallingParam to the anyOf[ToolSearchOutput]/tools/items/ response property anyOf list for the response status 200

      response-property-any-of-added

    This revision also has 1 change that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

  • 827fa3e74ce92See the full diff
    • ○

      added the optional property anyOf[AdditionalTools]/tools/items/anyOf[subschema #6: MCP tool]/tunnel_id to the response with the 200 status

      response-optional-property-added

    • ○

      added the optional property anyOf[ToolSearchOutput]/tools/items/anyOf[subschema #6: MCP tool]/tunnel_id to the response with the 200 status

      response-optional-property-added

  • d96e76a894f812See the full diff
    • ▲

      the response property anyOf[subschema #5: Web search tool call]/action/anyOf[subschema #1: Search action]/query became optional for the status 200

      response-property-became-optional

    • ○

      added AdditionalTools to the response body anyOf list for the response status 200

      response-body-any-of-added

    • ○

      response property anyOf[subschema #5: Web search tool call]/action/anyOf[subschema #1: Search action]/query deprecated

      response-property-deprecated

  • 737fbb7f6f1734See the full diff
    • ●

      added the new chatgpt-image-latest enum value to the anyOf[ToolSearchOutput]/tools/items/anyOf[subschema #8: Image generation tool]/model/anyOf[subschema #2]/ response property for the response status 200

      response-property-enum-value-added

    • ●

      added the new gpt-image-2 enum value to the anyOf[ToolSearchOutput]/tools/items/anyOf[subschema #8: Image generation tool]/model/anyOf[subschema #2]/ response property for the response status 200

      response-property-enum-value-added

    • ●

      added the new gpt-image-2-2026-04-21 enum value to the anyOf[ToolSearchOutput]/tools/items/anyOf[subschema #8: Image generation tool]/model/anyOf[subschema #2]/ response property for the response status 200

      response-property-enum-value-added

    • ○

      removed the 1024x1024 enum value from the anyOf[ToolSearchOutput]/tools/items/anyOf[subschema #8: Image generation tool]/size response property for the response status 200

      response-property-enum-value-removed

    • ○

      removed the 1024x1536 enum value from the anyOf[ToolSearchOutput]/tools/items/anyOf[subschema #8: Image generation tool]/size response property for the response status 200

      response-property-enum-value-removed

    • ○

      removed the 1536x1024 enum value from the anyOf[ToolSearchOutput]/tools/items/anyOf[subschema #8: Image generation tool]/size response property for the response status 200

      response-property-enum-value-removed

    • ○

      removed the auto enum value from the anyOf[ToolSearchOutput]/tools/items/anyOf[subschema #8: Image generation tool]/size response property for the response status 200

      response-property-enum-value-removed

  • 1b5c6501b84711See the full diff
    • ▲

      the anyOf[ToolSearchOutput]/tools/items/anyOf[subschema #8: Image generation tool]/size response's property type/format changed from string/ to / for status 200

      response-property-type-changed

    • ○

      added subschema #1 subschema #2 to the anyOf[ToolSearchOutput]/tools/items/anyOf[subschema #8: Image generation tool]/size response property anyOf list for the response status 200

      response-property-any-of-added