Obtener árbol de archivos de la aplicación
curl --request GET \
--url https://api.vertracloud.app/v1/apps/{id}/files/tree \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.vertracloud.app/v1/apps/{id}/files/tree', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.vertracloud.app/v1/apps/{id}/files/tree"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.vertracloud.app/v1/apps/{id}/files/tree"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}{
"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": []
}
]
}
}
Gestor de archivos
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.
GET
/
v1
/
apps
/
{id}
/
files
/
tree
Obtener árbol de archivos de la aplicación
curl --request GET \
--url https://api.vertracloud.app/v1/apps/{id}/files/tree \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.vertracloud.app/v1/apps/{id}/files/tree', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.vertracloud.app/v1/apps/{id}/files/tree"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.vertracloud.app/v1/apps/{id}/files/tree"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}{
"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": []
}
]
}
}
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 directamente sobre la carpeta.string
requerido
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.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
object
La entrada raíz, con los elementos hijos anidados de forma recursiva.
Mostrar Mostrar objeto
Mostrar Mostrar objeto
string
El nombre del archivo o de la carpeta.
string
La ruta completa del archivo o de la carpeta.
string
"file" o "directory".string
El tamaño del archivo, legible para personas (por ejemplo,
"12.34 KB"). Solo aparece en las entradas de tipo "file".string
La fecha y hora de la última modificación del archivo o de la carpeta.
array
Presente en las carpetas. Un array de entradas con esta misma forma.
{
"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
string
El código de error que indica el motivo del fallo. Valores posibles:
AUTH_TOKEN_MISSING,API_KEY_INVALID,SESSION_REVOKED: Falta la cabeceraAuthorization, 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.
{
"code": "ACCESS_DENIED"
}
{
"code": "APP_NOT_FOUND"
}
Última modificación el 28 de octubre de 2026