> ## 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.

# Obtener árbol de archivos de la aplicación

> Devuelve el árbol completo de archivos de una aplicación a partir de su ID, con las carpetas expandidas de forma recursiva.

> [!NOTE]
>
> El árbol llega hasta 6 niveles de profundidad y omite las carpetas de dependencias y de build (`node_modules`, `.git`,
> `vendor`, `__pycache__`, `target`, `.venv`, `venv`, `.next`, `.local`). Para explorar esas carpetas, usa
> [Listar archivos de la aplicación](https://docs.vertracloud.app/es-es/api-reference/endpoint/apps/filemanager/files.md) directamente sobre la carpeta.

**id** `string` *required*

El ID de la aplicación de la que se obtendrá el árbol de archivos. Si la aplicación pertenece a un workspace, pasa su ID en el parámetro de query `workspace_id`.

**workspace\_id** `string`

Si la aplicación pertenece a un workspace, el ID de ese workspace. Los miembros con el rol Propietario, Administrador o Desarrollador pueden usar el gestor de archivos en una aplicación del workspace que no les pertenece; sin este parámetro, solo puede hacerlo el propietario de la aplicación.

### Respuesta

**response** `object`

La entrada raíz, con los elementos hijos anidados de forma recursiva.

**Mostrar objeto**

**name** `string`

El nombre del archivo o de la carpeta.

**path** `string`

La ruta completa del archivo o de la carpeta.

**type** `string`

`"file"` o `"directory"`.

**size** `string`

El tamaño del archivo, legible para personas (por ejemplo, `"12.34 KB"`). Solo aparece en las entradas de tipo `"file"`.

**last\_modified** `string`

La fecha y hora de la última modificación del archivo o de la carpeta.

**children** `array`

Presente en las carpetas. Un array de entradas con esta misma forma.

```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": []
      }
    ]
  }
}
```

### Respuestas de error

**code** `string`

El código de error que indica el motivo del fallo. Valores posibles:

* `AUTH_TOKEN_MISSING`, `API_KEY_INVALID`, `SESSION_REVOKED`: Falta la cabecera `Authorization`, la clave de API no es válida o la sesión del panel fue revocada (`401`).
* `API_KEY_IP_DENIED`, `API_KEY_SCOPE_DENIED`: La clave de API se usa desde una IP fuera de su lista de permitidas, o no tiene el scope que requiere la ruta (`403`).
* `ACCESS_DENIED`: El recurso pertenece a otra cuenta, o no tienes el permiso de workspace necesario para él (`403`).
* `FORBIDDEN`: El usuario no tiene permiso para acceder a la aplicación.
* `APP_NOT_FOUND`: La aplicación indicada no existe.
* `PLAN_RESTRICTED_FEATURE`: El plan del usuario no admite el acceso al gestor de archivos.
* `INTERNAL_SERVER_ERROR`: No se pudo obtener el árbol de archivos.

```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.