Whitelabel Connections Enterprise (Beta)

📘

This feature is currently in beta and subject to change

For this example we'll be setting up a Google Drive connection. See the list below for all available connections.

Create an Authenticator

To create Whitelabel connections, you first need to create an Authenticator. This stores project information like the client_id and client_secret so that connections can refresh tokens. All data is encrypted. See the table at the bottom of this page for information on what type of authenticator a connection needs.

For Google Drive, we need credentials from Google, here's the request to create the Authenticator.

All authenticators require client_id and client_secret

curl --location 'https://ragie.ai/authenticators' \
--header 'Authorization: Bearer your_token' \
--header 'Content-Type: application/json' \
--data '{
  "provider": "google",
  "name": "My Google Authenticator",
  "client_id": "id",
  "client_secret": "secret"
}'

You'll get an id back.

If you ever need to see your authenticators the endpoint to list them is

curl --location 'https://ragie.ai/authenticators' \
--header 'Authorization: Bearer your_token'

Create a Connection

Okay, now we have our authenticator setup, we can create connections. You will have to provide what data you want to sync and this will usually mean getting specific ids.

For Google Drive a sample request is

curl --location 'https://ragie.ai/authenticators/963cad11-50d2-477b-94d7-d039beecf3db/connection' \
--header 'Authorization: Bearer your_token' \
--header 'Content-Type: application/json' \
--data '{
    "partition_strategy": {
        "static": "hi_res",
        "audio": true,
        "video": "audio_only"
    },
    "partition": "string",
    "page_limit": 1000,
    "metadata": {},
    "connection": {
        "provider": "google_drive",
        "data": [
            {
                "id": "id", 
                "name": "name",
                "mime_type": "application/vnd.google-apps.folder"
            }
        ],
        "email": "test",
        "credentials": {
            "refresh_token": "string"
        }
    }
}'

That's it!

After this request, the connection will be created and start syncing.

Available connections

Some connections have static tokens and don't need an Authenticator. See the list below

Connections that don't need Authenticators

• Backblaze
• Freshdesk
• GCS
• Intercom
• S3
• Zendesk