Google Drive

Sync a workspace to a Google Drive folder so any file added there is automatically ingested and indexed in LightOn. Files are kept in sync: additions, updates, and deletions in Drive flow through to the workspace on the next import. Synced workspaces are read-only: you cannot manually upload to or delete from them.

From the console

The fastest path is the console UI:

Create a new workspace from Workspaces → New.
Open the workspace, then choose Sync from Google Drive in its settings.
Paste the service account JSON, pick the folder, and trigger the first import.

Use this if you’d rather not handle credentials yourself.

From the API

Convert any manual workspace into a Google Drive-synced workspace by issuing a PATCH /api/v3/workspaces/{id} with a datasource object. Conversion is one-way: you cannot revert a synced workspace back to manual.

import requests, json

requests.patch(
    f"https://api.lighton.ai/api/v3/workspaces/{workspace_id}",
    headers={"Authorization": "Bearer $LIGHTON_API_KEY"},
    json={
        "datasource": {
            "type": "googledrive",
            "name": "Engineering Drive",
            "credentials": {
                "service_account_file": json.dumps(service_account_dict),
            },
            "filter_criteria": {
                "folder_id": "1AbCdEfGhIjKlMnOpQrStUvWxYz",
                "recursive": True,
            },
        },
    },
)

Credentials

service_account_file: JSON-encoded string of your Google service account credentials. The service account needs read access to the target folder.

Filter criteria

folder_id (required): the Google Drive folder ID to sync from. It’s the last path segment of the folder’s URL in Drive (drive.google.com/drive/folders/<folder_id>), or use POST /api/v3/workspaces/datasource/browse (alpha) to list the folders shared with your service account.
recursive (optional): include subfolders

The first import is scheduled immediately. Track progress on the workspace’s sync field returned by GET /api/v3/workspaces/{id}. For the full request shape, see PATCH /api/v3/workspaces/{id} in the API reference.

Integrations

Datasources

LLM Providers

From the console

From the API

​From the console

​From the API

From the console

From the API