Skip to main content
POST
List app files

Authorizations

Authorization
string
header
required

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.

Path Parameters

app_id
string
required

ID of the app whose sandbox to operate on.

Body

application/json
branch_id
string | null

Optional Base44 branch ID. Omit to operate on main.

path
string | null

Directory relative to the app root. Default: app root.

recursive
boolean
default:false

List nested entries.

max_depth
integer
default:3

Max depth when recursive.

Required range: 1 <= x <= 10
include_hidden
boolean
default:false

Include dotfiles.

Response

The listing.

The listing, and whether you got all of it.

entries
DirectoryEntry · object[]
required

Files and directories, capped at 1000 entries.

Example:
truncated
boolean
required

true when the listing hit the 1000-entry cap. Narrow it with path or a smaller max_depth.

Example:

false