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
OR

Changes

Changed in 16 of the 163 revisions of this API.62161

    • ○

      added the non-success response with the status

      response-non-success-status-added

    • ○

      response property oneOf[AdditionalTools]/tools/items/oneOf[subschema #6: MCP tool]/connector_id deprecated

      response-property-deprecated

    • ○

      response property oneOf[ToolSearchOutput]/tools/items/oneOf[subschema #6: MCP tool]/connector_id deprecated

      response-property-deprecated

    • ○

      added the optional property / to the response with the status

      response-optional-property-added

    • ○

      added the optional property / to the response with the status

      response-optional-property-added

    • ○

      added the optional property / to the response with the status

      response-optional-property-added

    • ○

      added the optional property / to the response with the status

      response-optional-property-added

    • ○

      added subschema #1 to the / response property anyOf list for the response status

      response-property-any-of-added

    • ○

      removed subschema #1 subschema #2 from the / response property anyOf list for the response status

      response-property-any-of-removed

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

    • ○

      added the optional property / to the response with the status

      response-optional-property-added

    • ○

      added the optional property / to the response with the status

      response-optional-property-added

    • ●

      added the new gpt-image-2.5-flare enum value to the //////// response property for the response status

      response-property-enum-value-added

    • ●

      added the new gpt-image-2.5-flare enum value to the //////// response property for the response status

      response-property-enum-value-added

    • ●

      added the new gpt-image-2.5-flare-2026-09-08 enum value to the //////// response property for the response status

      response-property-enum-value-added

    • ●

      added the new gpt-image-2.5-flare-2026-09-08 enum value to the //////// response property for the response status

      response-property-enum-value-added

    • ●

      added the new gpt-image-2.5-sunburst enum value to the //////// response property for the response status

      response-property-enum-value-added

    • ●

      added the new gpt-image-2.5-sunburst enum value to the //////// response property for the response status

      response-property-enum-value-added

    • ●

      added the new gpt-image-2.5-sunburst-2026-09-08 enum value to the //////// response property for the response status

      response-property-enum-value-added

    • ●

      added the new gpt-image-2.5-sunburst-2026-09-08 enum value to the //////// response property for the response status

      response-property-enum-value-added

    • ●

      added the new max enum value to the /////// response property for the response status

      response-property-enum-value-added

    • ●

      added the new max enum value to the /////// response property for the response status

      response-property-enum-value-added

    • ●

      added the new xhigh enum value to the /////// response property for the response status

      response-property-enum-value-added

    • ●

      added the new xhigh enum value to the /////// response property for the response status

      response-property-enum-value-added

    • ●

      added the new incomplete enum value to the / response property for the response status

      response-property-enum-value-added

  • 9430b00d75b4111See the full diff
    • ▲

      added to the response body oneOf list for the response status

      response-body-one-of-added

    • ○

      added the optional property / to the response with the status

      response-optional-property-added

    • ○

      added the optional property /////// to the response with the status

      response-optional-property-added

    • ○

      added the optional property ///////////// to the response with the status

      response-optional-property-added

    • ○

      added the optional property ////////// to the response with the status

      response-optional-property-added

    • ○

      added the optional property /////// to the response with the status

      response-optional-property-added

    • ○

      added the optional property ///// to the response with the status

      response-optional-property-added

    • ○

      added the optional property /////// to the response with the status

      response-optional-property-added

    • ○

      added the optional property ///////////// to the response with the status

      response-optional-property-added

    • ○

      added the optional property ////////// to the response with the status

      response-optional-property-added

    • ○

      added the optional property /////// to the response with the status

      response-optional-property-added

    • ○

      added the optional property / to the response with the status

      response-optional-property-added

    • ●

      removed the optional property //// from the response with the status

      response-optional-property-removed

    • ○

      added the optional property //// to the response with the status

      response-optional-property-added

    • ●

      added the new gpt-image-2 enum value to the //////// response property for the response status

      response-property-enum-value-added

    • ●

      added the new gpt-image-2 enum value to the //////// response property for the response status

      response-property-enum-value-added

    • ●

      added the new gpt-image-2-2026-04-21 enum value to the //////// response property for the response status

      response-property-enum-value-added

    • ●

      added the new gpt-image-2-2026-04-21 enum value to the //////// response property for the response status

      response-property-enum-value-added