List folders
Documents
List folders
Returns every folder the caller can see (their private folders, all team
folders, and the folders of channels they belong to), flat - the client
builds the tree from parent_id. Each row carries a live doc_count.
Requires documents:read.
GET
List folders
Authorizations
Personal Access Token. Send as Authorization: Bearer hq_pat_....
Query Parameters
Filter to one scope (private / team / channel); omit for all.
When true, return the caller's trashed folders (the top of each trashed
subtree) instead of live ones - the Trash view. Overrides scope.
Response
200 - application/json
Folders visible to the caller
Live documents directly in this folder.