---
title: "Get Volume File Content"
method: GET
path: "/api/v1/runtime/volume/file"
tags: ["runtime"]
---

# Get Volume File Content

`GET /api/v1/runtime/volume/file`

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

## Query parameters

- `path` string, required — Absolute or volume-relative file path to preview from the runtime volume.
- `max_bytes` integer — 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.

## Response `200`

Successful Response

- VolumeFileContentResponse — Response for runtime volume file-content preview endpoint.
  - `provider` 'daytona', required — Runtime volume backend used to satisfy the request.
  - `path` string, required — Normalized file path used for the preview request.
  - `mime` string, required — Detected MIME type for the returned content.
  - `size` integer, required — File size in bytes reported by the provider.
  - `sha256` string, nullable — SHA-256 hex digest of the full file bytes before truncation.
  - `encoding` string, nullable — Content encoding: 'utf-8' for clean text, 'utf-8-lossy' when replacement characters were introduced, or 'binary' for non-text files.
  - `content` string, required — UTF-8 text preview returned for the requested file. Empty for binary files.
  - `binary` boolean — True when the file was detected as binary; content will be empty.
  - `truncated` boolean — Whether the returned file content was truncated to respect max_bytes.

## Other responses

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

## Changes

- **2026-05-23** `6178f925cdec` — 1 breaking, 7 info
  - the `detail` response's property type changed from `array` to no type for status `422`
  - added the non-success response with the status `403`
  - added the optional property `binary` to the response with the `200` status
  - added the optional property `encoding` to the response with the `200` status
  - …4 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/file/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)