---
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

## Headers

- `workspace-key` string

## 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

- **2026-01-21** `1f956ac3d1c1` — 2 info
  - 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
  - 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
- **2025-12-19** `7073d8652386` — 1 info
  - added the new optional `header` request parameter `workspace-key`
- **2025-10-28** `849d5e8732f6` — 1 breaking, 1 info
  - added `#/components/schemas/TraceTool` to the `threads/items/history/items/tools/additionalProperties/` response property `oneOf` list for the response status `200`
  - added `trace` discriminator mapping keys to the `threads/items/history/items/tools/additionalProperties/` response property for the response status `200`
- …earlier changes not shown

[Full 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/1f956ac3d1c1/schema)