---
title: "Read thread"
method: GET
path: "/chat/threads/{threadId}"
tags: ["chat"]
---

# Read thread

`GET /chat/threads/{threadId}`

## Request

- Base URL: `https://www.dench.com/api/v1`
- URL: `https://www.dench.com/api/v1/chat/threads/{threadId}`
- Auth: one of:
  - HTTP bearer
  - HTTP bearer

Read a past chat thread.

## Path parameters

- `threadId` string, required

## Query parameters

- `limit` integer
- `visibleTextOnly` boolean: Message text as a person sees it: text parts only, without reasoning or tool calls.

## Response `200`

Successful response

- object
  - `thread` object, required
    - `threadId` string, required
    - `title` string, required
    - `lastMessageAt` number, required
    - `createdAt` number, required
    - `status` 'idle' | 'streaming' | 'error', required
    - `visibility` 'private' | 'shared', required
    - `createdByUserId` string, required
    - `archivedAt` number, nullable, required
    - `fileContextPath` string, nullable, required
    - `parentThreadId` string, nullable, required: Parent thread when this is a spawned sub-agent.
    - `nestingDepth` number, nullable, required
    - `summary` string, nullable, required
    - `activeRunId` string, nullable, required
  - `messages` object[], required
    - `id` string, required
    - `role` 'user' | 'assistant' | 'system', required
    - `createdAt` number, required
    - `updatedAt` number, required
    - `text` string, required
    - `runId` string, nullable, required
    - `status` 'streaming' | 'complete' | 'error' | 'canceled', nullable, required
    - `revision` number, required
    - `isDraft` boolean, required

## Other responses

- `400`: Invalid request
- `401`: Missing or invalid authentication
- `404`: Operation or resource not found
- `500`: Server error

---

[API](https://skmtc.dev/dench/apis/dench-api.md) - [All operations](https://skmtc.dev/dench/apis/dench-api/llms.txt) - [OpenAPI document](https://skmtc.dev/dench/apis/dench-api/revisions/4a145b38f19c?raw)