> ## Documentation Index
> Fetch the complete documentation index at: https://docs.vertracloud.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Obter conteúdo de arquivo da aplicação

> Retorna o conteúdo de um arquivo específico de uma aplicação pelo seu ID.

**id** `string` *required*

O ID da aplicação da qual o conteúdo do arquivo será obtido. Se a aplicação pertencer a um workspace, informe o ID dele no parâmetro de query `workspace_id`.

**workspace\_id** `string`

Se a aplicação pertencer a um workspace, o ID do workspace. Membros com papel de Owner, Admin ou Developer podem usar o gerenciador de arquivos em uma aplicação do workspace que não é deles; sem isso, somente o dono da aplicação pode.

**path** `string` *required*

O caminho do arquivo cujo conteúdo será obtido.

### Resposta

**response** `object`

O conteúdo do arquivo solicitado.

**Mostrar objeto**

**type** `string`

Sempre `"base64"`.

**data** `string`

O conteúdo do arquivo, codificado em base64 padrão (com padding).

**size** `number`

O tamanho do arquivo em bytes. É o tamanho real do arquivo, não o comprimento da string base64.

**last\_modified** `string`

A data de modificação (mtime) do arquivo. Envie este valor de volta no corpo de [`PUT /files`](https://docs.vertracloud.app/pt-br/api-reference/endpoint/apps/filemanager/save) como `last_modified` para detectar conflitos de edição.

```json Response theme={null}
{
  "response": {
    "type": "base64",
    "data": "SGVsbG8gV29ybGQ=",
    "size": 11,
    "last_modified": "2026-03-14T19:58:00Z"
  }
}
```

### Respostas de erro

**code** `string`

O código de erro que indica o motivo da falha. Valores possíveis:

* `AUTH_TOKEN_MISSING`, `API_KEY_INVALID`, `SESSION_REVOKED`: o cabeçalho `Authorization` está ausente, a chave de API é inválida ou a sessão do painel foi revogada (`401`).
* `API_KEY_IP_DENIED`, `API_KEY_SCOPE_DENIED`: a chave de API está sendo usada a partir de um IP fora da sua lista de permissões, ou não tem o escopo que a rota exige (`403`).
* `FORBIDDEN` / `ACCESS_DENIED`: o usuário não tem permissão para acessar a aplicação.
* `APP_NOT_FOUND`: a aplicação especificada não existe.
* `PLAN_RESTRICTED_FEATURE`: o plano do usuário não oferece suporte ao acesso ao gerenciador de arquivos.
* `MISSING_PATH`: o parâmetro de query `path` não foi informado.
* `FILE_NOT_FOUND`: o arquivo solicitado não existe.
* `FILE_TOO_LARGE`: o arquivo ultrapassa o limite de 10 MB para obtenção de conteúdo.
* `FILE_CONTENT_ERROR`: falha ao obter o conteúdo do arquivo.

**message** `string`

Uma mensagem descritiva com detalhes adicionais sobre o erro.

```json Error Response (403) theme={null}
{
  "code": "API_KEY_SCOPE_DENIED"
}
```

```json Error Response (404) theme={null}
{
  "code": "FILE_NOT_FOUND"
}
```

```json Error Response (400) theme={null}
{
  "code": "FILE_TOO_LARGE",
  "message": "File exceeds the 10 MB limit for content retrieval"
}
```

```json Error Response (400) theme={null}
{
  "code": "MISSING_PATH",
  "message": "Path query parameter is required"
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.