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

# List threads

`GET /threads`

List threads in a project, optionally filtered by status.

## Query parameters

- `projectId` string, uuid — Project to list threads for. Auto-filled from CLI and SDK context when omitted.
- `limit` integer — Maximum number of threads to return per page.
- `cursor` string, uuid — Cursor from a previous response's nextCursor to fetch the next page.
- `status` 'regular' | 'archived' — Filter by thread status. 'regular' returns active threads, 'archived' returns archived threads.

## Response `200`

OK

- object
  - `threads` object[], required — The page of threads matching the query.
    - `id` string, uuid, required
    - `projectId` string, uuid, required
    - `title` string, nullable, required
    - `status` 'regular' | 'archived', required
    - `source` 'slack' | 'teams' | 'linear' | 'github' | 'app' | 'mcp' | 'agent' | 'api' | 'cli' | 'web' | 'sdk' | 'bitbucket' | 'system', nullable, required
    - `createdAt` string, date-time, required
    - `updatedAt` string, date-time, required
  - `nextCursor` string, uuid, nullable, required — Pass as 'cursor' to fetch the next page. Null when there are no more results.

---

[API](https://skmtc.dev/sazabi/apis/sazabi-public-api.md) · [All operations](https://skmtc.dev/sazabi/apis/sazabi-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/sazabi/sazabi-public-api/revisions/1d12b71c735a/schema)