Skip to main content
search_documents Search for documents and folders by name across all workspaces the user has access to, most recently updated first. Returns matches with full path context (workspace, project, parent folder) AND a format field (‘editor’ | ‘docx’ | ‘pdf’ | ‘folder’) so you can pick the right tool family per document. Use this to find documents by name when the user references them informally without @-mentions. If multiple matches are returned, ask the user to disambiguate using the workspace/project context shown. The result’s page says how many match; pass page.nextOffset to continue.

​
Parameters

​
string
required
Search query — case-insensitive substring match against document and folder names.
​
string, enum: 'FILE' | 'FOLDER'
Optional: limit results to FILE or FOLDER only.
​
integer
Where to start. Pass the previous result’s page.nextOffset. Minimum: 0.
​
integer
Max results to return (default 20, max 50). Minimum: 1.