List a Folder's Children

List the direct children of a folder. The response items are a discriminated union of subfolders and files: subfolders are returned first (alphabetical), then files (alphabetical).

GET /folders/{id}/children

List a folder's children

cURL

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

200

{
  "items": [
    {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "name": "<string>",
      "description": "<string>",
      "path": "/My Files/Contracts",
      "parent_folder_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "folder_type": "<string>",
      "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.

Path Parameters

id · string<uuid> · required

The folder ID

Response

200

application/json

Direct children of the folder

items · object[] · required

Direct children of the folder. Subfolders first (alphabetical), then files (alphabetical).

Option 1

Option 2

Show child attributes