Obter árvore de arquivos da aplicação
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": []
}
]
}
}
Gerenciador de arquivos
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.
GET
/
v1
/
apps
/
{id}
/
files
/
tree
Obter árvore de arquivos da aplicação
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": []
}
]
}
}
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 diretamente na pasta.string
obrigatório
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.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
object
A entrada raiz, com os filhos aninhados recursivamente.
Mostrar Mostrar objeto
Mostrar Mostrar objeto
string
O nome do arquivo ou pasta.
string
O caminho completo do arquivo ou pasta.
string
"file" ou "directory".string
O tamanho do arquivo, em formato legível (por exemplo
"12.34 KB"). Presente somente para entradas do tipo "file".string
O timestamp de quando o arquivo ou pasta foi modificado pela última vez.
array
Presente nos diretórios. Um array de entradas com este mesmo formato.
{
"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
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çalhoAuthorizationestá 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.
{
"code": "ACCESS_DENIED"
}
{
"code": "APP_NOT_FOUND"
}
Última modificação em 28 de outubro de 2026