List folders

Retrieve all folders in your workspace. Folders are used to organize projects, docs, channels, dashboards, agents, and other folders into a hierarchical structure — similar to a file system.

Results can be filtered by title or parent folder, sorted by creation date or title, and are paginated.

Tip: To list only root-level folders, filter with filter[parent_folder_id]=null. To list children of a specific folder, set filter[parent_folder_id] to that folder's ID.

Note: The folders field (containing child folder IDs) is only populated when filtering by parent_folder_id. Without this filter, folders will be null for performance reasons. To retrieve child folders for a specific folder, either use filter[parent_folder_id] or call the Get folder (GET /v1/folders/:folder_id) endpoint.