> ## Documentation Index
> Fetch the complete documentation index at: https://developers.myhero.so/llms.txt
> Use this file to discover all available pages before exploring further.

# 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…

`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

<ParamField path="query" type="string" required>
  Search query — case-insensitive substring match against document and folder names.
</ParamField>

<ParamField path="type" type="string, enum: 'FILE' | 'FOLDER'">
  Optional: limit results to FILE or FOLDER only.
</ParamField>

<ParamField path="limit" type="number">
  Max results to return (default 20, max 50).
</ParamField>