---
title: "List channel themes"
method: GET
path: "/v1/channels/{channel_id}/themes"
tags: ["Channels"]
---

# List channel themes

`GET /v1/channels/{channel_id}/themes`

Retrieve all themes for a channel. Themes are AI-generated clusters of data points that share a common subject within a topic. Each theme has a `title` (a short label summarising the cluster), an optional `summary` (a longer AI-generated description of what data points in the theme share in common), and a `datum_count` (the number of data points currently classified into the theme).

Results are sorted by `datum_count:desc` by default and are paginated using cursor-based pagination.

> 🚧 Permissions
>
> Please check you have the relevant permissions required to access this resource. This may include specific permissions on the object itself or its parent, or having the correct user role if you're making updates.

## Path parameters

- `channel_id` string, required

## Query parameters

- `page` object
  - `start_cursor` string
  - `limit` integer, nullable
- `sort` union
  - 'datum_count:asc' | 'datum_count:desc' | 'created_at:asc' | 'created_at:desc'
  - string[]

## Response `200`

200

- object
  - `data` object[], required
    - `id` string, required
    - `url` string — The URL of this theme in the Dovetail web app.
    - `channel` object, required
      - `id` string, required
    - `title` string, required
    - `summary` string, nullable, required
    - `datum_count` number, required
    - `created_at` string, required
    - `topic` object, nullable, required
      - `id` string, required
      - `title` string, required
  - `page` object, required
    - `total_count` number, required — Total number of items matching the query.
    - `has_more` boolean, required — Whether there are more items beyond the current page.
    - `next_cursor` string, nullable, required — Cursor to pass as `page[start_cursor]` to fetch the next page. Null when there are no more results.

## Other responses

- `400` — 400
- `401` — 401
- `403` — 403
- `404` — 404
- `422` — 422
- `429` — 429
- `500` — 500

---

[API](https://skmtc.net/dovetail/apis/dovetail-public-api.md) · [All operations](https://skmtc.net/dovetail/apis/dovetail-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/dovetail/dovetail-public-api/revisions/4107f5fdf8b2/schema)