Skip to main content
GET
/
v1
/
organizations
/
connections
/
{connection_identifier}
/
folders
List Google Drive Folders
curl --request GET \
  --url https://api.mixpeek.com/v1/organizations/connections/{connection_identifier}/folders \
  --header 'Authorization: <authorization>'
{
  "folders": [
    {
      "id": "<string>",
      "name": "<string>",
      "path": "<string>",
      "mime_type": "<string>"
    }
  ],
  "parent_path": "<string>"
}

Headers

Authorization
string
required

REQUIRED: Bearer token authentication using your API key. Format: 'Bearer sk_xxxxxxxxxxxxx'. You can create API keys in the Mixpeek dashboard under Organization Settings.

Path Parameters

connection_identifier
string
required

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

Query Parameters

path
string
default:/

Parent folder path to list from

Response

Successful Response

Response payload for listing Google Drive folders.

Returns a list of folders available at the specified path, enabling users to browse and select folders for sync configuration.

folders
FolderItem · object[]
required

List of folders found at the specified parent path. Only includes folders (not files). Empty list if no folders found or path doesn't exist.

parent_path
string
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.