Skip to main content
GET
List folders
Requires the folders:read scope. You must be a member of the workspace. Access-restricted members only receive folders they have been explicitly granted access to.

Path parameters

string
required
The numeric workspace ID.

Response

Returns an array of folder objects.
number
required
Folder identifier.
number
required
ID of the workspace this folder belongs to.
string
required
Folder name.
string | null
Icon identifier slug (e.g., "folder-1", "folder-2", "library"). null if not set.
string | null
Folder color.
number
required
Numeric sort position. Folders are ordered by this value ascending.
string
required
UTC ISO-8601 creation timestamp.