Skip to main content
GET
/
files
Search files
curl --request GET \
  --url https://app.generalcounsel.ai/api/external/v1/files \
  --header 'Authorization: <api-key>'
{
  "files": [
    {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "name": "<string>",
      "size": 123,
      "content_type": "<string>",
      "status": "extracting",
      "created_at": "<string>",
      "folder_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
    }
  ]
}

Documentation Index

Fetch the complete documentation index at: https://docs.gc.ai/llms.txt

Use this file to discover all available pages before exploring further.

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. 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.