---
title: "List Agent Playground Threads"
method: GET
path: "/api/v1/agent-definitions/{definition_id}/playground/threads"
tags: ["authed"]
---

# List Agent Playground Threads

`GET /api/v1/agent-definitions/{definition_id}/playground/threads`

## Request

- Base URL: `https://api.teaflask.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.teaflask.com/api/v1/agent-definitions/{definition_id}/playground/threads`
- Auth: none declared

The playground's conversation switcher: the caller's own threads
pinned to this definition, most recently touched first. Page with the
last row's updated_at and id as before_updated_at/before_id; a full
page means more may exist. Same writer gate as the door itself — these
conversations exist nowhere else.

## Path parameters

- `definition_id` string, uuid, required

## Query parameters

- `before_updated_at` string, date-time, nullable
- `before_id` string, uuid, nullable
- `limit` integer

## Response `200`

Successful Response

- AssistantThreadResponse[]
  - `id` string, uuid, required
  - `title` string, required
  - `busy` boolean, required
  - `stream_thread_id` string, required
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, required

## Other responses

- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not found
- `405`: Method not allowed
- `422`: Validation error
- `500`: Internal server error

---

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