Get Application File Tree

GET

apps

{id}

files

tree

Get Application File Tree

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));

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

The tree goes up to 6 levels deep and skips dependency and build folders (node_modules, .git, vendor, __pycache__, target, .venv, venv, .next, .local). To browse those, use List Application Files on the folder directly.

string

required

The ID of the application to retrieve the file tree from. If the application belongs to a workspace, pass its ID in the workspace_id query parameter.

string

If the application belongs to a workspace, the workspace’s ID. Members with an Owner, Admin or Developer role can use the file manager on a workspace app they don’t own; without this, only the app’s own owner can.

Response

object

The root entry, with children nested recursively.

Show Toggle object

string

The name of the file or folder.

string

The full path to the file or folder.

string

Either "file" or "directory".

string

The file size, human-readable (e.g. "12.34 KB"). Only present for entries of type "file".

string

The timestamp when the file or folder was last modified.

array

Present on directories. An array of entries with this same shape.

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

Error Responses

string

The error code indicating the reason for failure. Possible values:

AUTH_TOKEN_MISSING, API_KEY_INVALID, SESSION_REVOKED: The Authorization header is missing, the API key is invalid, or the dashboard session was revoked (401).
API_KEY_IP_DENIED, API_KEY_SCOPE_DENIED: The API key is used from an IP outside its allowlist, or it lacks the scope the route requires (403).
ACCESS_DENIED: The resource belongs to another account, or you lack the workspace permission for it (403).
FORBIDDEN: The user does not have permission to access the application.
APP_NOT_FOUND: The specified application does not exist.
PLAN_RESTRICTED_FEATURE: The user’s plan does not support file manager access.
INTERNAL_SERVER_ERROR: Failed to retrieve the file tree.

{
  "code": "ACCESS_DENIED"
}

{
  "code": "APP_NOT_FOUND"
}

Last modified on October 26, 2026

Get Application File Tree

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));

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

Overview

Endpoints

Get Application File Tree

Response

Error Responses

​Response

​Error Responses

Response

Error Responses