List documents
Returns the documents visible to the caller, newest first, along with the distinct categories and tags across that visible set for building filter sidebars. Visibility is enforced per request: team-scoped documents are seen by everyone in the workspace, private ones only by their owner, and channel-scoped ones only by members of that channel. Optional query parameters scope, category, channel, and tags (comma-separated, matching documents that carry all listed tags) narrow the results, and limit defaults to 50 and is capped at 200. Requires the documents:read scope.
Authorizations
Personal Access Token. Send as Authorization: Bearer hq_pat_....
Query Parameters
Filter to one scope; omit for "everything I can see".
Filter to one category; omit for all.
Filter to docs that have ALL listed tags. Comma-separated.
Filter to one channel (only useful with scope=channel).
Filter to documents directly inside this folder.
When true, only documents at the root of their scope (folder_id IS NULL). Ignored when folder is set.
When true, return the caller's Trash (their soft-deleted documents) instead of live ones. Overrides scope/folder/root filters.
Default 50, max 200.