---
title: "List Files"
method: GET
path: "/api/files"
tags: ["files", "files"]
---

# List Files

`GET /api/files`

## 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/files`
- Auth: none declared

Return paginated files for workspace.

When `search` is provided AND `offset == 0`, additionally fans out a
vector-image search via the RAG service and appends image-MIME hits
that the filename ILIKE didn't already match. This way a user typing
"watercolor cat" finds the cat photo even when the filename is a
Voyage UUID.

## Query parameters

- `limit` integer
- `offset` integer: Pagination offset
- `status` string, nullable: Filter by status
- `thread_id` integer, nullable: Restrict to thread
- `search` string, nullable: Search by filename, title, or visual content (image vector search)

## Response `200`

Successful Response

- FileListResponse: List wrapper with pagination info.
  - `files` FileResponse[], required
    - `id` integer, required
    - `title` string, nullable
    - `description` string, nullable
    - `status` string, required
    - `ingest_type` string, required
    - `latest_version` integer, required
    - `mime_type` string, nullable
    - `byte_size` integer, nullable
    - `original_filename` string, nullable
    - `thread_id` integer, nullable
    - `source_url` string, nullable
    - `metadata` object
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required
    - `versions` FileVersionResponse[]
      - `id` integer, required
      - `file_id` integer, required
      - `version_number` integer, required
      - `storage_bucket` string, required
      - `storage_key` string, required
      - `mime_type` string, nullable
      - `byte_size` integer, nullable
      - `checksum_sha256` string, nullable
      - `created_at` string, date-time, required
      - `download_url` string, nullable
      - `thumbnail_url` string, nullable
    - `thumbnail_url` string, nullable
    - `chunk_count` integer: Number of RAG chunks for this file
  - `total` integer: Total number of files matching filters
  - `offset` integer: Current offset
  - `limit` integer: Requested limit
  - `has_more` boolean: Whether more files are available

## 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)