---
title: "List Sandbox Files"
method: GET
path: "/api/v1/runs/{id}/sandbox/files"
tags: ["Human-in-the-Loop"]
---

# List Sandbox Files

`GET /api/v1/runs/{id}/sandbox/files`

Lists directory entries from the run's sandbox environment.

## Path parameters

- `id` string, required

## Query parameters

- `path` string, required
- `depth` integer

## Response `200`

Directory entries

- SandboxFileListResponse — Non-paginated list of sandbox directory entries.
  - `data` SandboxFileEntry[], required
    - `name` string, required — Basename of the entry.
    - `is_dir` boolean, required — Whether the entry is a directory.
    - `size` integer — File size in bytes when known.

## Other responses

- `404` — Run not found
- `409` — Run has no active sandbox

---

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