---
title: "List threads"
method: GET
path: "/chat/threads"
tags: ["chat"]
---

# List threads

`GET /chat/threads`

## Request

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

List past chat threads.

## Query parameters

- `titleQuery` string
- `limit` integer
- `includeArchived` boolean
- `includeAutomated` boolean
- `excludeThreadId` string

## Response `200`

Successful response

- object[]
  - `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

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