List Folders Linked to a Project

List folders linked to a project. To enumerate the contents of a folder, call GET /folders/{id}/children.

GET /projects/{id}/folders

List folders linked to a project

cURL

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

200

{
  "folders": [
    {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "name": "<string>",
      "description": "<string>",
      "folder_type": "<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 linked folders

folders · object[] · required

Show child attributes

pagination · object · required

Show child attributes