---
title: "List knowledge files"
method: GET
path: "/v1/knowledge/files"
tags: ["External API"]
---

# List knowledge files

`GET /v1/knowledge/files`

List customer-visible files under `user_generated/` and `skills/`. Use `prefix` to narrow the listing.

## Query parameters

- `prefix` string, nullable — List files at or under this path. Must be `user_generated`, `skills`, or a child of those roots. Omit to list both roots.
- `page` integer, nullable — 1-indexed page number.
- `limit` integer, nullable — Page size (max 100).

## Response `200`

Successful Response

- ListKnowledgeFilesResponse — Paginated list of knowledge files.
  - `files` KnowledgeFileResponse[], required — Files in the current page.
    - `path` string, required — POSIX path under `user_generated/` or `skills/`.
    - `content_type` string, required — Stored content type.
    - `size_bytes` integer, required — File size in bytes.
    - `sha256` string, required — Hex SHA-256 of the file bytes.
    - `etag` string, required — Opaque version token for conditional requests.
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required
  - `count` integer, required — Number of files in the current page.
  - `total` integer, required — Total matching files across all pages.
  - `prev` integer, nullable — Previous page number, if any.
  - `next` integer, nullable — Next page number, if any.

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `500` — Internal Server Error
- `4XX` — Client error returned in the V1 error envelope.

---

[API](https://skmtc.dev/traversal/apis/fastapi.md) · [All operations](https://skmtc.dev/traversal/apis/fastapi/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/traversal/fastapi/revisions/01ca496f3b4f/schema)