---
title: "Read a file from an application"
method: GET
path: "/v2/apps/{appId}/files/content"
tags: ["File Manager"]
---

# Read a file from an application

`GET /v2/apps/{appId}/files/content`

Returns the file at the given `path` as a JSON object `{ type: "Buffer", data: number[] }` where `data` is the raw byte array. Clients reconstruct the file by reading the `data` array.

Requires the workspace Maintainer or Administrator role (or ownership) when called against a workspace-shared application.

## Path parameters

- `appId` string, required

## Query parameters

- `path` string, required

## Response `200`

File content as a byte-array JSON object.

- object
  - `status` 'success', required
  - `response` object, required
    - `type` 'Buffer', required
    - `data` integer[], required — File bytes as integers in [0, 255].

## Other responses

- `400` — Path validation failed.
- `401` — The Authorization header is missing, malformed, or the credentials are not valid.
- `403` — The workspace member does not have the required permission for this endpoint.
- `404` — The file does not exist at the given path.
- `413` — The file is too large to read through the file manager.
- `429` — The authenticated user or API key exceeded the global request budget.
- `500` — An unexpected error occurred while processing the request.

---

[API](https://skmtc.dev/squarecloud/apis/square-cloud-api.md) · [All operations](https://skmtc.dev/squarecloud/apis/square-cloud-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/squarecloud/square-cloud-api/revisions/54b7733a6b95/schema)