v1

latestOpenAPI 3.1.02026-07-175793186.0 KB
runtime

Get Volume File Content

Read a text preview for a single file from the runtime volume.

get/api/v1/runtime/volume/file

Query parameters

pathstring required

Absolute or volume-relative file path to preview from the runtime volume.

Absolute or volume-relative file path to preview from the runtime volume.

max_bytesinteger

Maximum number of bytes of text content to return in the preview response.

Maximum number of bytes of text content to return in the preview response.

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.

pathstring required

Normalized file path used for the preview request.

mimestring required

Detected MIME type for the returned content.

sizeinteger required

File size in bytes reported by the provider.

sha256string nullable

SHA-256 hex digest of the full file bytes before truncation.

encodingstring nullable

Content encoding: 'utf-8' for clean text, 'utf-8-lossy' when replacement characters were introduced, or 'binary' for non-text files.

contentstring required

UTF-8 text preview returned for the requested file. Empty for binary files.

binaryboolean

True when the file was detected as binary; content will be empty.

truncatedboolean

Whether the returned file content was truncated to respect max_bytes.