---
title: "Get Threads With Histories"
method: GET
path: "/api/conversation/{conversation_ext_id}/threads"
tags: ["conversation"]
---

# Get Threads With Histories

`GET /api/conversation/{conversation_ext_id}/threads`

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

## Path parameters

- `conversation_ext_id` string, required

## Response `200`

Successful Response

- ThreadsResponse
  - `conversation_ext_id` string, required
  - `threads` Thread[], required
    - `leaf_message_ext_id` string, required
    - `history` MessageResponse[], required
      - `role` 'user' | 'assistant' | 'system', required
      - `content` string, required
      - `tools` object
      - `config_ext_id` string, nullable
      - `shared` boolean
      - `external_id` string, required
      - `created_at` string, date-time, required
      - `created_by_ext_id` string, required
      - `conversation_ext_id` string, required
      - `parent_message_ext_id` string, nullable

## Other responses

- `422` — Validation Error

## Changes

- **2025-08-19** `5287337ab0fe` — 1 warning, 1 info
  - removed the optional property `threads/items/history/items/configurations_name` from the response with the `200` status
  - added the optional property `threads/items/history/items/config_ext_id` to the response with the `200` status
- **2025-08-06** `43c12480eb1b` — 5 breaking, 1 warning, 9 info
  - added `#/components/schemas/ModelCitationTool, #/components/schemas/RetrievalChunkTool-Output, #/components/schemas/RetrievalFullContextTool-Output` to the `threads/items/history/items/tools/additionalProperties/` response property `oneOf` list for the response status `200`
  - the `threads/items/history/items/tools/additionalProperties/` response's property type changed from `object` to no type for status `200`
  - removed the required property `threads/items/history/items/tools/additionalProperties/description` from the response with the `200` status
  - removed the required property `threads/items/history/items/tools/additionalProperties/name` from the response with the `200` status
  - …11 more

[Change history](https://skmtc.dev/arbicity/apis/arbi/changes/api/conversation/:conversation_ext_id/threads/get.md)

---

[API](https://skmtc.dev/arbicity/apis/arbi.md) · [All operations](https://skmtc.dev/arbicity/apis/arbi/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/arbicity/arbi/revisions/84efd317dcde/schema)