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

> Search for projects by name across all workspaces the user has access to. Returns each match's _id, name, description, workspaceId, and workspaceName so…

`search_projects`

Search for projects by name across all workspaces the user has access to. Returns each match's \_id, name, description, workspaceId, and workspaceName so you can pick the right one without needing a workspaceId up front. ALWAYS use this before create\_project when the user references a project by name — it prevents creating duplicates in the wrong workspace. If multiple matches are returned, ask the user to disambiguate using workspace context.

## Parameters

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

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