v1

latestOpenAPI 3.1.02026-07-175793186.0 KB
runtime

Get Volume Tree

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

get/api/v1/runtime/volume/tree

Query parameters

root_pathstring

Directory path to list within the selected runtime volume.

Directory path to list within the selected runtime volume.

max_depthinteger

Maximum directory depth to traverse while building the file tree.

Maximum directory depth to traverse while building the file tree.

max_entriesinteger

Maximum total node entries to return while building the file tree.

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.

Optional runtime volume backend override. Defaults to the active sandbox provider.

Response

Successful Response

provider'daytona' required

Runtime volume backend used to satisfy the request.

volume_namestring required

Resolved volume name used for the listing request.

root_pathstring required

Normalized root path used for the listing request.

allowed_rootsstring[]

Canonical volume roots that may be addressed by tree and file requests.

total_filesinteger

Total file count returned in the current response payload.

total_dirsinteger

Total directory count returned in the current response payload.

truncatedboolean

Whether the provider truncated the tree because of depth or payload limits.

max_depthinteger required

Depth limit applied to the tree request.

max_entriesinteger required

Entry limit applied to the tree request.

entries_returnedinteger required

Total node entries returned in this response.