---
title: "List Google Drive folders for store ingestion"
method: GET
path: "/v1/integrations/google_drive/folders"
tags: ["integrations"]
---

# List Google Drive folders for store ingestion

`GET /v1/integrations/google_drive/folders`

List Google Drive files and folders and whether each is selected for store ingestion.

## Query parameters

- `installation_id` string, uuid, required — Google Drive installation ID
- `folder_id` string, nullable — Google Drive folder ID to browse

## Response `200`

Google Drive folder selection for an account

- GoogleDriveFolderSelectionResponse — Google Drive folder selection response.
  - `data` GoogleDriveFolderSelection, required — Google Drive folder selection for a store connector.
    - `is_installed` boolean, required — Whether Google Drive is installed for the organization
    - `installation_id` string, nullable — Google Drive installation ID
    - `account_email` string, nullable — Connected Google account email
    - `store_id` string, nullable — Mixedbread store ID
    - `store_name` string, nullable — Mixedbread store name
    - `auto_sync_all` boolean — Whether the entire Drive (all current and future files) is synced automatically
    - `current_folder_id` string, nullable — Current Google Drive browser folder ID
    - `breadcrumbs` GoogleDriveBreadcrumb[] — Breadcrumb path for the current Google Drive browser folder
      - `id` string, nullable — Google Drive folder ID, or null for My Drive root
      - `name` string, required — Google Drive folder name
    - `items` GoogleDriveItem[] — Files and folders in the current Google Drive browser folder
      - `id` string, required — Google Drive file or folder ID
      - `name` string, required — Google Drive item name
      - `type` 'file' | 'folder', required — Whether this Drive item is a file or folder
      - `mime_type` string, nullable — Google Drive MIME type
      - `web_view_link` string, nullable — Google Drive web view link
      - `modified_time` string, date-time, nullable — Google Drive modified time
      - `is_selected` boolean — Whether this item is directly selected for store ingestion
      - `sync_state` 'syncing' | 'partial' | 'not_syncing' — Current sync state for this visible Drive item
      - `unsupported_reason` string, nullable — Reason this file cannot be imported, or null when import is supported
      - `import_status` GoogleDriveImportResult — Last async import outcome for a Google Drive file.
        - `status` 'indexed' | 'skipped' | 'failed', required — Last import outcome for this Drive file
        - `updated_at` string, date-time, required — When this import outcome was recorded
        - `error_code` 'unsupported_file_type' | 'unsupported_export' | 'empty_file' | 'invalid_file' | 'unsupported_detected_mime' | 'google_drive_api_error', nullable — Machine-readable import failure reason, if the file was skipped or failed
        - `message` string, nullable — User-facing import failure reason, if the file was skipped or failed
    - `selected_folder_ids` string[] — Every Google Drive folder ID selected for ingestion
    - `selected_file_ids` string[] — Every Google Drive file ID selected for ingestion
    - `excluded_children` GoogleDriveExcludedChildren[] — Direct child exclusions grouped by selected parent folder
      - `parent_folder_id` string, required — Selected Google Drive parent folder ID
      - `child_ids` string[], required — Direct child Drive file or folder IDs excluded under the parent
    - `folders` GoogleDriveFolder[], required — Available Google Drive folders
      - `id` string, required — Google Drive folder ID
      - `name` string, required — Google Drive folder name
      - `is_selected` boolean — Whether this folder is selected for store ingestion
      - `web_view_link` string, nullable — Google Drive web view link
      - `last_synced_at` string, date-time, nullable — Last successful sync time

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/mixedbread/apis/mxbai-omni.md) · [All operations](https://skmtc.net/mixedbread/apis/mxbai-omni/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/mixedbread/mxbai-omni/revisions/2eece97b5ae5/schema)