---
title: "Get Volume Tree"
method: GET
path: "/api/v1/runtime/volume/tree"
tags: ["runtime"]
---

# Get Volume Tree

`GET /api/v1/runtime/volume/tree`

List the runtime volume tree for the active workspace and provider.

## Query parameters

- `root_path` string — Directory path to list within the selected runtime volume.
- `max_depth` integer — Maximum directory depth to traverse while building the file tree.
- `max_entries` integer — Maximum total node entries to return while building the file tree.
- `provider` 'daytona', nullable — Optional runtime volume backend override. Defaults to the active sandbox provider.

## Response `200`

Successful Response

- VolumeTreeResponse — Response for the volume tree listing endpoint.
  - `provider` 'daytona', required — Runtime volume backend used to satisfy the request.
  - `volume_name` string, required — Resolved volume name used for the listing request.
  - `root_path` string, required — Normalized root path used for the listing request.
  - `allowed_roots` string[] — Canonical volume roots that may be addressed by tree and file requests.
  - `nodes` VolumeTreeNode[], required — Tree nodes rooted at the requested path.
    - `id` string, required — Stable node identifier used by the frontend tree view.
    - `name` string, required — Display name for the file-system node.
    - `path` string, required — Absolute path for the file-system node within the runtime volume.
    - `type` 'volume' | 'directory' | 'file', required — Kind of file-system node represented by this entry.
    - `children` VolumeTreeNode[] — Child nodes for directory or volume entries.
    - `size` integer, nullable — File size in bytes when the provider reports one.
    - `modified_at` string, nullable — Last modified timestamp when the provider reports one.
  - `total_files` integer — Total file count returned in the current response payload.
  - `total_dirs` integer — Total directory count returned in the current response payload.
  - `truncated` boolean — Whether the provider truncated the tree because of depth or payload limits.
  - `max_depth` integer, required — Depth limit applied to the tree request.
  - `max_entries` integer, required — Entry limit applied to the tree request.
  - `entries_returned` integer, required — Total node entries returned in this response.

## Other responses

- `400` — The requested root path is invalid.
- `401` — Authentication is required or the provided token is invalid.
- `403` — The requested root is outside the canonical runtime volume roots.
- `422` — Validation Error
- `502` — The runtime volume provider failed to list the requested path.
- `503` — Runtime services are unavailable because server startup is incomplete.
- `504` — Volume listing timed out before the backend returned a result.

---

[API](https://skmtc.net/qredence/apis/fleet-rlm.md) · [All operations](https://skmtc.net/qredence/apis/fleet-rlm/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/qredence/fleet-rlm/versions/62e8c152aa18/schema)