v5

latestOpenAPI 3.1.02026-08-025631,1012.8 MB

Organization Connections

List Google Drive Folders

List folders in Google Drive for folder selection in sync configuration.

Enables users to browse and select folders when configuring sync operations. Only available for Google Drive connections.

Use Cases:

Browse available folders for sync configuration
Select source folder for bucket sync
Navigate nested folder structures

Example:

curl -X GET "http://localhost:8000/v1/organizations/connections/conn_abc123/folders?path=/Marketing" \
  -H "Authorization: Bearer YOUR_API_KEY"

get/v1/organizations/connections/{connection_identifier}/folders

Path parameters

connection_identifierstring required

Connection identifier - either connection ID (conn_...) or name. The system will automatically resolve names to IDs.

Example:conn_abc123def456ghi

Connection identifier - either connection ID (conn_...) or name. The system will automatically resolve names to IDs.

Query parameters

pathstring

Parent folder path to list from

Response

Successful Response

parent_pathstring required

The parent folder path that was queried. This is the path specified in the request (or '/' for root). Use this to show breadcrumb navigation in UI.

Example response

{
  "description": "List of folders at root",
  "folders": [
    {
      "id": "0AH-Xabc123",
      "mime_type": "application/vnd.google-apps.folder",
      "name": "Marketing",
      "path": "/Marketing"
    },
    {
      "id": "0AH-Xdef456",
      "mime_type": "application/vnd.google-apps.folder",
      "name": "Sales",
      "path": "/Sales"
    }
  ],
  "parent_path": "/"
}