---
title: "List Files"
method: GET
path: "/filesystems/{filesystem_id}/files"
tags: ["Filesystems"]
---

# List Files

`GET /filesystems/{filesystem_id}/files`

List files in the filesystem manifest with optional filtering.

## Path parameters

- `filesystem_id` string, required

## Query parameters

- `directory` string — Directory prefix to filter results
- `recursive` boolean — Include subdirectories
- `mime_type` string, nullable — Filter by MIME type
- `include_content` boolean — Include file content in response
- `limit` integer — Maximum number of results
- `offset` integer — Pagination offset

## Response `200`

Successful Response

- ListFilesResponse — Response model for listing files in a filesystem.
  - `files` FilesystemFileResponse[], required — List of file entries.
    - `checksum` string, nullable — SHA256 checksum (None for directories).
    - `content` string, nullable — File contents (None for binary/large files).
    - `content_truncated` boolean — True if content was truncated due to size.
    - `is_binary` boolean — True if file is binary.
    - `is_directory` boolean — Whether this entry is a directory.
    - `mime_type` string, nullable — MIME type (None for directories).
    - `modified_at` string, date-time, required — File's last modification time.
    - `path` string, required — Relative path within filesystem (e.g., 'src/index.ts').
    - `size_bytes` integer, nullable — File size in bytes (None for directories).
    - `synced_at` string, date-time, required — When this entry was last synced.
  - `filesystem_id` string, required — The filesystem ID.
  - `synced_at` string, date-time, nullable — When the manifest was last synced.
  - `total_count` integer, required — Total number of matching files.

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/terminaluse/apis/sb0-api.md) · [All operations](https://skmtc.net/terminaluse/apis/sb0-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/terminaluse/sb0-api/versions/f24a474dc415/schema)