Optiak Docs
Connections

Connect Data Sources

Manage source access and file uploads for organization Data Integrations.

Connect an external source account or upload files so an organization Data Integration can sync documents. An Organization Admin connects the source account. Applications can retrieve its synced documents without a separate sign-in.

Required role

Organization Admin

Applies to

LLM requests
Organization Admins authorize the source account and choose which applications can use the Data Integration.

How connections work

An Organization Admin connects an external source or uploads files through the Data Integration form. For external sources, the Data Integration and its assigned applications share the authorized account. Optiak reads source content during a sync and does not change the source files or pages.

Source access depends on the provider. For example, Google Drive reads files from one selected folder, while Notion reads pages shared with the Optiak integration in the authorized workspace. The Data Integration's scope determines which applications may use the setup, and each application must enable it before its requests can retrieve documents.

The following diagram illustrates the process of connecting data sources and retrieving information. The upper lane shows source content being prepared and indexed; the lower shows an application question retrieving matching passages, passing them to the model, and returning an answer.

Index documents

Uploaded files
Google Drive folder
Notion shared pages
Prepare chunksSplit and embed
Vector databaseStores document vectors
Vector queryThe Gateway sends the question to the index.
Retrieved passagesMatching content returns to model context.

Answer a question

Application question
Optiak Gateway
Relevant passagesAdded to model context
LLM provider
Answer to application
Documents are indexed after upload or sync; relevant passages are retrieved for each request.

Before you connect

  • Use an Organization Admin account to create Data Integrations and manage their connections.
  • For an external source, have access to the account and content you want to sync. For File Upload, have the files ready.
  • Confirm your organization permits connecting the external account to Optiak; obtain approval if required.
  • Decide which projects or applications should access the documents, then set the Data Integration's Scope accordingly.

Available connections

After you connect

Connected sources sync when an Organization Admin starts a sync. Each sync adds new documents, updates changed ones, and removes documents no longer available from the source, such as files no longer in a selected Google Drive folder or pages no longer shared with the Notion integration. Source changes reach applications after the next sync. File uploads do not need a sync; added or deleted files take effect immediately. To sync a connected source again, select Sync on the Data Integration.

Set the Scope to include the projects or applications that need the documents. Application admins then open the application's Configuration → Data integrations and enable the setup. See Data Integrations for how retrieval works.

Troubleshooting

  • Connection required: the connection was removed. Edit the Data Integration and connect the source account again. Reactivate the setup if it was deactivated, then sync it.
  • Needs reconnect: the provider rejected the saved authorization. Edit the Data Integration, select Reconnect, and authorize the account again.
  • Sync failed: check that the setup is active, the Google Drive folder ID is correct, or the intended Notion pages are shared with the integration. Reconnect if needed, then select Sync again.
  • Syncing: a sync is already running. Wait for it to finish before starting another one.
Copyright © 2026