List Projects

List projects accessible to the authenticated user, optionally filtered by name.

Requires a user-scoped API key (u:gcai_...). Projects are scoped per-user via access control: the user sees projects they created, projects shared with them, and any non-access-controlled projects in the organization.

GET /projects

List projects

cURL

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

200

{
  "projects": [
    {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "name": "<string>",
      "description": "<string>",
      "custom_instructions": "<string>",
      "is_access_controlled": true,
      "created_at": "<string>",
      "updated_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.

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

search · string

Case-insensitive substring match on project name

Response

200

application/json

Paginated list of projects

projects · object[] · required

Show child attributes

pagination · object · required

Show child attributes