Get a Folder

Retrieve a single folder by ID.

GET /folders/{id}

Get a folder

cURL

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

200

{
  "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

Folder details

id · string<uuid> · required

Unique folder identifier

name · string · required

Folder name

description · string | null · required

Folder description, or null if unset

path · string · required

Path through ancestors visible to the requester. Inaccessible ancestors are skipped, so this may not reflect absolute depth. Use parent_folder_id to traverse hierarchy.

Example:

"/My Files/Contracts"

parent_folder_id · string<uuid> | null · required

Parent folder ID, or null for root

folder_type · string · required

Folder type (custom, my-files, etc.)

created_at · string · required

ISO 8601 creation timestamp