Skip to main content
GET
Search files

Authorizations

Authorization
string
header
required

API key for authentication. Format: gcai_xxxxxxxxx

Create API keys in the GC AI app under Settings → API.

Query Parameters

q
string
required

Search query (required)

Minimum string length: 1
Example:

"force majeure"

scope
enum<string>

Optional scope filter (user-scoped keys only). When omitted, searches all files the user can read. Mutually exclusive with project_id.

Available options:
my-files,
shared-with-me,
organization
Example:

"my-files"

project_id
string<uuid>

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
object[]
required

Files matching the query, ranked by hybrid (vector + keyword) relevance. At most 100 results.