Skip to main content

​
Available Connectors

ConnectorStatusDescription
Google Drive✅ AvailableSync files and folders
Notion✅ AvailableSync pages and databases

​
Workflow

​
1. Initiate OAuth Connection

curl -X POST https://api.cuadra.ai/v1/connections \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "connectorSlug": "google_drive",
    "redirectUrl": "https://your-app.com/oauth/callback"
  }'
Response: 
{
  "id": "conn_abc123",
  "status": "pending",
  "authorizationUrl": "https://accounts.google.com/o/oauth2/auth?..."
}
Redirect the user to authorizationUrl to complete OAuth.

​
2. Browse Remote Resources

After OAuth completes, browse available files/folders: 
curl "https://api.cuadra.ai/v1/connections/conn_abc123/resources" \
  -H "Authorization: Bearer YOUR_TOKEN"

​
3. Create Sync Configuration

curl -X POST https://api.cuadra.ai/v1/connections/conn_abc123/sync-configs \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Marketing Docs",
    "remoteResourceId": "folder_123",
    "remoteResourceType": "folder",
    "targetDatasetId": "ds_abc123",
    "syncFrequency": "daily"
  }'

​
4. Trigger Sync

curl -X POST https://api.cuadra.ai/v1/sync-configs/config_abc123/sync \
  -H "Authorization: Bearer YOUR_TOKEN"

​
Sync Frequencies

FrequencyDescription
manualOnly sync when triggered via API
dailySync once per day
weeklySync once per week

​
Connection Status

StatusDescription
pendingAwaiting OAuth authorization
activeConnected and ready to sync
expiredToken expired, needs re-authorization
errorConnection error

Knowledge Bases

Using connectors with datasets

Datasets API

Manage datasets