conversation

Get Threads With Histories

Retrieve all conversation threads (leaf messages and their histories) for a given conversation external ID.

get/api/conversation/{conversation_ext_id}/threads

Path parameters

conversation_ext_idstring required

Headers

workspace-keystring

Response

Successful Response

conversation_ext_idstring required

Changes

Changed in 6 of the 34 revisions of this API.7218

Jan 21, 20261f956ac3d1c12See the full diff
- ○
  added the optional property threads/items/history/items/tools/additionalProperties/oneOf[subschema #2: RetrievalChunkTool]/tool_responses/additionalProperties/items/metadata/heading to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property threads/items/history/items/tools/additionalProperties/oneOf[subschema #3: RetrievalFullContextTool]/tool_responses/additionalProperties/items/metadata/heading to the response with the 200 status
  response-optional-property-added
Dec 19, 20257073d86523861See the full diff
- ○
  added the new optional header request parameter workspace-key
  new-optional-request-parameter
This revision also has 3 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Oct 28, 2025849d5e8732f611See the full diff
- ▲
  added TraceTool to the threads/items/history/items/tools/additionalProperties/ response property oneOf list for the response status 200
  response-property-one-of-added
- ○
  added trace discriminator mapping keys to the threads/items/history/items/tools/additionalProperties/ response property for the response status 200
  response-property-discriminator-mapping-added
This revision also has 8 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Oct 6, 20258d3e894e6c0b14See the full diff
- ▲
  the threads/items/history/items/tools/additionalProperties/oneOf[subschema #1: ModelCitationTool]/tool_responses/additionalProperties/ response's property type/format changed from array/ to object/ for status 200
  response-property-type-changed
- ○
  added the required property threads/items/history/items/tools/additionalProperties/oneOf[subschema #1: ModelCitationTool]/tool_responses/additionalProperties/chunk_ids to the response with the 200 status
  response-required-property-added
- ○
  added the required property threads/items/history/items/tools/additionalProperties/oneOf[subschema #1: ModelCitationTool]/tool_responses/additionalProperties/offset_end to the response with the 200 status
  response-required-property-added
- ○
  added the required property threads/items/history/items/tools/additionalProperties/oneOf[subschema #1: ModelCitationTool]/tool_responses/additionalProperties/offset_start to the response with the 200 status
  response-required-property-added
- ○
  added the required property threads/items/history/items/tools/additionalProperties/oneOf[subschema #1: ModelCitationTool]/tool_responses/additionalProperties/statement to the response with the 200 status
  response-required-property-added
This revision also has 1 change that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Aug 19, 20255287337ab0fe11See the full diff
- ●
  removed the optional property threads/items/history/items/configurations_name from the response with the 200 status
  response-optional-property-removed
- ○
  added the optional property threads/items/history/items/config_ext_id to the response with the 200 status
  response-optional-property-added
This revision also has 2 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Aug 6, 202543c12480eb1b519See the full diff
- ▲
  added ModelCitationTool RetrievalChunkTool-Output RetrievalFullContextTool-Output to the threads/items/history/items/tools/additionalProperties/ response property oneOf list for the response status 200
  response-property-one-of-added
- ▲
  the threads/items/history/items/tools/additionalProperties/ response's property type/format changed from object/ to / for status 200
  response-property-type-changed
- ▲
  removed the required property threads/items/history/items/tools/additionalProperties/description from the response with the 200 status
  response-required-property-removed
- ▲
  removed the required property threads/items/history/items/tools/additionalProperties/name from the response with the 200 status
  response-required-property-removed
- ▲
  removed the required property threads/items/history/items/tools/additionalProperties/tool_args from the response with the 200 status
  response-required-property-removed
- ●
  removed the optional property threads/items/history/items/tools/additionalProperties/tool_responses from the response with the 200 status
  response-optional-property-removed
- ○
  the response property threads/items/history/items/created_at became required for the status 200
  response-property-became-required
- ○
  the response property threads/items/history/items/external_id became required for the status 200
  response-property-became-required
- ○
  added discriminator to threads/items/history/items/tools/additionalProperties/ response property for the response status 200
  response-property-discriminator-added
- ○
  response property threads/items/history/items/created_at list-of-types was narrowed by removing types null from media type application/json of response 200
  response-property-list-of-types-narrowed
- ○
  response property threads/items/history/items/external_id list-of-types was narrowed by removing types null from media type application/json of response 200
  response-property-list-of-types-narrowed
- ○
  the threads/items/history/items/external_id response's property pattern ^msg-[a-zA-Z0-9]{8}$ was added for the status 200
  response-property-pattern-added
- ○
  the threads/items/history/items/parent_message_ext_id/anyOf[subschema #1]/ response's property pattern ^msg-[a-zA-Z0-9]{8}$ was added for the status 200
  response-property-pattern-added
- ○
  added the required property threads/items/history/items/conversation_ext_id to the response with the 200 status
  response-required-property-added
- ○
  added the required property threads/items/history/items/created_by_ext_id to the response with the 200 status
  response-required-property-added
This revision also has 13 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

Full history