Search files

curl --request GET \
  --url https://app.gc.ai/api/external/v1/files \
  --header 'Authorization: <api-key>'

{
  "files": [
    {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "name": "<string>",
      "size": 123,
      "content_type": "<string>",
      "folder_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "created_at": "<string>"
    }
  ]
}

Files

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” tree
shared-with-me: files explicitly shared with the user (and files inside shared folders)
organization: files in the organization’s “Organization Files” tree

GET

files

Search files

curl --request GET \
  --url https://app.gc.ai/api/external/v1/files \
  --header 'Authorization: <api-key>'

{
  "files": [
    {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "name": "<string>",
      "size": 123,
      "content_type": "<string>",
      "folder_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "created_at": "<string>"
    }
  ]
}

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

string

required

Search query (required)

Minimum string length: 1

Example:

"force majeure"

scope

enum<string>

Optional scope filter. When omitted, searches all files the user can read.

Available options:

my-files,

shared-with-me,

organization

Example:

"my-files"

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.

Show child attributes

Get File Status Move a File

⌘I