List Files on a Project

List files directly linked to a project. Files reachable only via a linked folder are not included; list those folders separately with GET /projects/{id}/folders.

GET /projects/{id}/files

List files on a project

cURL

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

200

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

Authorizations

Authorization · string · header · required

API key for authentication. Format: gcai_xxxxxxxxx

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

Path Parameters

id · string<uuid> · required

The project ID

Query Parameters

limit · integer · default: 100

Max items to return (default 100, max 500)

Required range: 1 <= x <= 500

offset · integer | null · default: 0

Number of items to skip (default 0)

Required range: x >= 0

Response

200

application/json

Paginated list of files

files · object[] · required

Show child attributes

pagination · object · required

Show child attributes