> ## 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 árvore de arquivos da aplicação

> Retorna a árvore completa de arquivos de uma aplicação pelo seu ID, com as pastas expandidas recursivamente.

> [!NOTE]
>
> A árvore vai até 6 níveis de profundidade e ignora as pastas de dependências e de build (`node_modules`, `.git`,
> `vendor`, `__pycache__`, `target`, `.venv`, `venv`, `.next`, `.local`). Para navegar por elas, use
> [Obter arquivos da aplicação](https://docs.vertracloud.app/pt-br/api-reference/endpoint/apps/filemanager/files.md) diretamente na pasta.

**id** `string` *required*

O ID da aplicação da qual a árvore de arquivos será obtida. 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.

### Resposta

**response** `object`

A entrada raiz, com os filhos aninhados recursivamente.

**Mostrar objeto**

**name** `string`

O nome do arquivo ou pasta.

**path** `string`

O caminho completo do arquivo ou pasta.

**type** `string`

`"file"` ou `"directory"`.

**size** `string`

O tamanho do arquivo, em formato legível (por exemplo `"12.34 KB"`). Presente somente para entradas do tipo `"file"`.

**last\_modified** `string`

O timestamp de quando o arquivo ou pasta foi modificado pela última vez.

**children** `array`

Presente nos diretórios. Um array de entradas com este mesmo formato.

```json Response theme={null}
{
  "response": {
    "type": "directory",
    "name": "/",
    "path": "/",
    "last_modified": "2026-03-14T19:58:00Z",
    "children": [
      {
        "type": "file",
        "name": "index.js",
        "path": "/index.js",
        "size": "1.24 KB",
        "last_modified": "2026-03-14T19:58:00Z"
      },
      {
        "type": "directory",
        "name": "src",
        "path": "/src",
        "last_modified": "2026-03-14T19:58:00Z",
        "children": []
      }
    ]
  }
}
```

### 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`).
* `ACCESS_DENIED`: o recurso pertence a outra conta, ou você não tem a permissão do workspace para ele (`403`).
* `FORBIDDEN`: 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.
* `INTERNAL_SERVER_ERROR`: falha ao obter a árvore de arquivos.

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

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


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