Obter arquivos da aplicação
curl --request GET \
--url https://api.vertracloud.app/v1/apps/{id}/files \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.vertracloud.app/v1/apps/{id}/files', 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"
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"
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": "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"
}
]
}
Gerenciador de arquivos
Obter arquivos da aplicação
Retorna a lista de arquivos e pastas de uma aplicação pelo seu ID.
GET
/
v1
/
apps
/
{id}
/
files
Obter arquivos da aplicação
curl --request GET \
--url https://api.vertracloud.app/v1/apps/{id}/files \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.vertracloud.app/v1/apps/{id}/files', 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"
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"
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": "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"
}
]
}
string
obrigatório
O ID da aplicação da qual os arquivos serão listados. 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.
string
O caminho relativo de onde os arquivos serão listados. Padrão: o diretório raiz (
/).Resposta
array
Um array de objetos de arquivo ou pasta.
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"; diretórios não trazem tamanho.string
O timestamp de quando o arquivo ou pasta foi modificado pela última vez.
{
"response": [
{
"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"
}
]
}
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 lista de arquivos.
string
Uma mensagem descritiva com detalhes adicionais sobre o erro.
{
"code": "ACCESS_DENIED"
}
{
"code": "APP_NOT_FOUND"
}
{
"code": "PLAN_RESTRICTED_FEATURE"
}
Última modificação em 28 de outubro de 2026