Skip to main content
GET
List Folders
With no parameters this returns every folder in the project, at any depth. Each one carries its full path, so one call is enough to build the whole tree.
Every folder
To walk the tree one level at a time, the way a file browser does, pass path (or parentId=null for the root level):
Direct children of avatars/2024
Root folders only
Every folder includes its full path from the project root, so you can link straight to it or reuse it as the folder value on an upload. A path that names no folder returns an empty folders array with currentFolder: null. See Folders & Paths.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

path
string

List the children of this folder path (relative to the project root). An unknown path returns an empty list.

Example:

"avatars/2024"

parentId
string

List the children of this folder UUID. Pass the literal null to list root folders explicitly.

Response

A list of folders

folders
object[]
currentFolder
object | null

The folder named by path/parentId, if any.