Skip to main content
search_documents Search for documents and folders by name across all workspaces the user has access to. Returns up to 20 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.

Parameters

query
string
required
Search query — case-insensitive substring match against document and folder names.
type
string, enum: 'FILE' | 'FOLDER'
Optional: limit results to FILE or FOLDER only.
limit
number
Max results to return (default 20, max 50).