---
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.

## Changes

- **2026-05-23** `6178f925cdec` — 1 breaking, 9 info
  - the `detail` response's property type/format changed from `array`/`` to ``/`` for status `422`
  - added the new optional `query` request parameter `max_entries`
  - added the non-success response with the status `403`
  - added the optional property `allowed_roots` to the response with the `200` status
  - …6 more
- **2026-04-24** `bc84369f4232` — 1 warning
  - deleted the `query` request parameter `volume_name`
- **2026-04-22** `939336a35a17` — 1 info
  - added the new optional `query` request parameter `volume_name`
- **2026-04-06** `4849c311977f` — 2 breaking, 3 info
  - removed the enum value `daytona` from the property `anyOf[subschema #1]/` of the `query` request parameter `provider`
  - removed the enum value `modal` from the property `anyOf[subschema #1]/` of the `query` request parameter `provider`
  - the `provider` response property const value `daytona` was added for the status `200`
  - removed the `daytona` enum value from the `provider` response property for the response status `200`
  - …1 more
- **2026-03-31** `a88715bea2c5` — 1 info
  - the endpoint scheme security `HTTPBearer` was added to the API

[Full history](https://skmtc.dev/qredence/apis/fleet-rlm/changes/api/v1/runtime/volume/tree/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-service-production.skmtc.workers.dev/v1/apis/qredence/fleet-rlm/revisions/e25aaded81b9/schema)