Search Files
Hybrid (vector + keyword) search across accessible files. Results are ranked by relevance and capped at 100.
User-scoped keys search all files the user can read. Org-scoped keys search all non-access-controlled files in the organization.
Pass scope (user-scoped keys only) to constrain the search to one of the three top-level meta-collections shown in the GC AI UI:
my-files: files in the user’s personal “My Files” treeshared-with-me: files explicitly shared with the user (and files inside shared folders)organization: files in the organization’s “Organization Files” tree
Pass project_id (user- or org-scoped keys) to constrain the search to the files linked to one project, e.g. searching a project of contracts for specific terms. Mutually exclusive with scope. To list a project’s files without a query, use GET /projects/{id}/files instead.
Authorizations
API key for authentication. Format: gcai_xxxxxxxxx
Create API keys in the GC AI app under Settings → API.
Query Parameters
Search query (required)
1"force majeure"
Optional scope filter (user-scoped keys only). When omitted, searches all files the user can read. Mutually exclusive with project_id.
my-files, shared-with-me, organization "my-files"
Optional project filter. Constrains the search to files linked to this project. Mutually exclusive with scope.
Response
Files matching the query, ranked by relevance
Files matching the query, ranked by hybrid (vector + keyword) relevance. At most 100 results.