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: Bearer <token>'
{
  "results": [
    {
      "id": "<string>",
      "name": "<string>",
      "path": "<string>",
      "mime_type": "<string>"
    }
  ],
  "parent_path": "<string>"
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
connection_identifier
string
required

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

Examples:

"conn_abc123def456ghi"

"Marketing Google Drive"

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.

​
results
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.

Examples:

"/"

"/Marketing"

"/Marketing/2024 Campaigns"