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

# List Workspace Files

`GET /api/files`

## Query parameters

- `path` string — Workspace-relative path
- `limit` integer
- `after` string, nullable

## Response `200`

Successful Response

- WorkspaceFileListResponse
  - `entries` WorkspaceFileEntryResponse[], required
    - `path` string, required
    - `kind` 'file' | 'directory', required
    - `byte_size` integer, nullable
    - `modified_at` string, nullable
    - `checksum_sha256` string, nullable
  - `truncated` boolean
  - `next_cursor` string, nullable

## Other responses

- `400` — Workspace file request is invalid
- `404` — Workspace file not found
- `422` — Validation Error
- `503` — Workspace files are unavailable

## Changes

- **2026-09-14** `571850c93e2c` — 3 info
  - added the non-success response with the status `400`
  - added the non-success response with the status `404`
  - added the non-success response with the status `503`
- **2026-07-25** `7a85443866b7` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/qredence/apis/fleet-rlm/changes/api/files/get.md)

---

[API](https://skmtc.dev/qredence/apis/fleet-rlm.md) · [All operations](https://skmtc.dev/qredence/apis/fleet-rlm/llms.txt) · [OpenAPI document](https://skmtc.dev/qredence/apis/fleet-rlm/revisions/6109fdb187b9?raw)