List app folders
curl --request GET \
--url https://app.base44.com/api/app-folders/tree \
--header 'Authorization: Bearer <token>'import requests
url = "https://app.base44.com/api/app-folders/tree"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://app.base44.com/api/app-folders/tree', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://app.base44.com/api/app-folders/tree",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://app.base44.com/api/app-folders/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))
}HttpResponse<String> response = Unirest.get("https://app.base44.com/api/app-folders/tree")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://app.base44.com/api/app-folders/tree")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"workspace_folders": [
{
"app_type": "user_app",
"color": "#3B82F6",
"created_date": "2026-08-01T09:15:00",
"icon": "briefcase",
"id": "68c1f2a9b4e7d3005a2c9e11",
"name": "Client projects",
"position": 2,
"scope": "workspace"
}
],
"personal_folders": [
{
"app_type": "user_app",
"color": "#3B82F6",
"created_date": "2026-08-01T09:15:00",
"icon": "briefcase",
"id": "68c1f27eb4e7d3005a2c9e0f",
"name": "Drafts",
"position": 1,
"scope": "personal"
}
],
"favorite_folder_ids": [
"68c1f2a9b4e7d3005a2c9e11"
]
}App folders
List app folders
This API is in beta. Endpoints, fields, and behavior may still change, so avoid depending on it in production.
Returns the folders you can see in the workspace: its workspace folders, which every member sees, and your personal folders, which only you see.
A folder holds builder apps or agents, never both. Set app_type to user_agent to list agent folders.
Each folder names the folder it sits in through parent_folder_id, so build the tree from that. This returns folders only. To list the apps in a folder, call List apps with folder_id.
This is limited to 300 requests per minute. A signed-in session has its own limit, and every personal access token for the workspace shares one. Some workspaces have a different limit.
Call this with a personal access token sent as a Bearer token, or from a signed-in session. A token works on its own workspace’s folders. Workspace API keys aren’t accepted, and a read-only token works.
GET
/
api
/
app-folders
/
tree
List app folders
curl --request GET \
--url https://app.base44.com/api/app-folders/tree \
--header 'Authorization: Bearer <token>'import requests
url = "https://app.base44.com/api/app-folders/tree"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://app.base44.com/api/app-folders/tree', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://app.base44.com/api/app-folders/tree",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://app.base44.com/api/app-folders/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))
}HttpResponse<String> response = Unirest.get("https://app.base44.com/api/app-folders/tree")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://app.base44.com/api/app-folders/tree")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"workspace_folders": [
{
"app_type": "user_app",
"color": "#3B82F6",
"created_date": "2026-08-01T09:15:00",
"icon": "briefcase",
"id": "68c1f2a9b4e7d3005a2c9e11",
"name": "Client projects",
"position": 2,
"scope": "workspace"
}
],
"personal_folders": [
{
"app_type": "user_app",
"color": "#3B82F6",
"created_date": "2026-08-01T09:15:00",
"icon": "briefcase",
"id": "68c1f27eb4e7d3005a2c9e0f",
"name": "Drafts",
"position": 1,
"scope": "personal"
}
],
"favorite_folder_ids": [
"68c1f2a9b4e7d3005a2c9e11"
]
}Authorizations
Personal access token, sent as Authorization: Bearer <token>. Each operation lists the permission it needs: read_only or full_access. A full-access token can call every operation. A read-only token can call only the operations that list read_only; anything else returns 403 read_only_credential_route_not_allowed.
Query Parameters
Which folders to list: user_app for builder app folders, or user_agent for agent folders. Defaults to user_app, and so does any other value.
Response
The folders you can see.
Workspace folders, sorted by position.
Show child attributes
Show child attributes
Example:
[
{
"app_type": "user_app",
"color": "#3B82F6",
"created_date": "2026-08-01T09:15:00",
"icon": "briefcase",
"id": "68c1f2a9b4e7d3005a2c9e11",
"name": "Client projects",
"position": 2,
"scope": "workspace"
}
]
Your personal folders, sorted by position.
Show child attributes
Show child attributes
Example:
[
{
"app_type": "user_app",
"color": "#3B82F6",
"created_date": "2026-08-01T09:15:00",
"icon": "briefcase",
"id": "68c1f27eb4e7d3005a2c9e0f",
"name": "Drafts",
"position": 1,
"scope": "personal"
}
]
IDs of the folders in this response that you starred in the Base44 dashboard.
Example:
["68c1f2a9b4e7d3005a2c9e11"]
Was this page helpful?