---
title: "List threads"
method: GET
path: "/threads"
---

# List threads

`GET /threads`

## Request

- Base URL: `https://api.agentsky.dev/v1`
- URL: `https://api.agentsky.dev/v1/threads`
- Auth: HTTP bearer

The caller's conversation threads for this workspace (single-agent and multi-agent alike), as the sidebar rail shows them. `?filter=all` includes archived threads; `?archived=true` lists only archived ones.

## Query parameters

- `filter` 'active' | 'archived' | 'all'
- `archived` boolean

## Headers

- `X-Universe` string

## Response `200`

OK

- object
  - `threads` ThreadSummary[], required
    - `id` string, required
    - `title` string, required
    - `openerText` string, nullable
    - `columnCount` integer, required
    - `agents` object[], required
      - `columnId` string, required
      - `agentType` string, required
      - `llm` string, required
      - `sessionId` string
    - `attention` 'needs_you' | 'working' | 'done' | 'idle' | 'null', nullable
    - `statusLine` string, nullable
    - `working` boolean, required
    - `updatedAt` string, date-time, required
    - `archived` boolean, required
    - `pinned` boolean, required

## Other responses

- `401`: Error — { error: { code, message } }
- `default`: Error — { error: { code, message, request_id } }

## Changes

- **2026-11-02** `e5e8f0229a99`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/agentsky/apis/agentsky-developer-api/changes/threads/get.md)

---

[API](https://skmtc.dev/agentsky/apis/agentsky-developer-api.md) - [All operations](https://skmtc.dev/agentsky/apis/agentsky-developer-api/llms.txt) - [OpenAPI document](https://skmtc.dev/agentsky/apis/agentsky-developer-api/revisions/8280a065ef6a?raw)