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).
Default 50, max 200.
Response
Documents visible to the caller
Total rows matching the unread + search filter, before paging.
Unread across the whole inbox (drives the nav badge) - independent of the current page / search / sort.