---
title: "List Collections"
method: GET
path: "/api/knowledge/collections"
tags: ["knowledge", "knowledge"]
---

# List Collections

`GET /api/knowledge/collections`

## Request

- Base URL: `https://api.dialogbrain.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.dialogbrain.com/api/knowledge/collections`
- Auth: none declared

List all knowledge collections for the workspace.

Auto-collections (is_auto=true) are hidden by default. They are per-prompt
collections created automatically when users upload files directly to a prompt.

## Query parameters

- `include_files` boolean: Include files in each collection
- `include_inactive` boolean: Include inactive collections
- `include_auto` boolean: Include auto-collections (hidden by default)
- `search` string, nullable: Search by name

## Response `200`

Successful Response

- CollectionListResponse: Response for listing collections.
  - `collections` CollectionResponse[], required
    - `id` integer, required
    - `user_id` integer, required
    - `name` string, required
    - `description` string, nullable
    - `is_active` boolean
    - `file_count` integer
    - `chunk_count` integer
    - `prompt_count` integer
    - `channel_count` integer
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required
    - `files` CollectionFileResponse[]
      - `file_id` integer, required
      - `title` string, nullable
      - `original_filename` string, nullable
      - `mime_type` string, nullable
      - `byte_size` integer, nullable
      - `status` string, required
      - `chunk_count` integer
      - `priority` integer
      - `is_enabled` boolean
      - `is_pinned` boolean
      - `added_at` string, date-time, required
      - `thumbnail_url` string, nullable
      - `web_url` string, nullable
  - `total` integer, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/dialogbrain/apis/dialogbrain-v2-api-gateway.md) · [All operations](https://skmtc.dev/dialogbrain/apis/dialogbrain-v2-api-gateway/llms.txt) · [OpenAPI document](https://skmtc.dev/dialogbrain/apis/dialogbrain-v2-api-gateway/revisions/77bef09a9209?raw)