Skip to Content
ConnectorsDropbox

Dropbox Connector

Sync files from your Dropbox folders into Knowledge Raven.

What Gets Synced

Knowledge Raven supports the following file formats from Dropbox:

FormatMax Size
PDF (.pdf)50 MB
Word (.docx)50 MB
Text (.txt)50 MB
Markdown (.md)50 MB
CSV (.csv)50 MB
PowerPoint (.pptx)50 MB
Excel (.xlsx)50 MB

Files with other extensions are skipped. Files exceeding the size limit are skipped.

How to Connect

Step 1 — Open Connectors

In your Knowledge Raven Dashboard, navigate to Connectors and click Add Connector, then select Dropbox.

Step 2 — Authorize with Dropbox

You will be redirected to Dropbox’s OAuth authorization page. Knowledge Raven uses OAuth 2.0 with PKCE for secure authorization.

When prompted, make sure to select token_access_type=offline to receive a refresh token (required for background sync). Knowledge Raven handles this automatically.

Step 3 — Select Folders

After authorization, Knowledge Raven lists your Dropbox folder hierarchy. Select the folders you want to sync.

Step 4 — Select a Knowledge Base

Choose which Knowledge Raven knowledge base the synced content should appear in.

Step 5 — Initial Sync

Knowledge Raven downloads eligible files from the selected folders and indexes them.

Change Detection

Dropbox uses content hash-based change detection — Knowledge Raven stores the Dropbox content_hash for each file and only re-downloads files whose hash has changed.

Token Handling

Dropbox refresh tokens are stable — they do not rotate on each use (unlike Atlassian). Knowledge Raven stores them securely using AES-256 encryption. Only the short-lived access token (~4 hours) is refreshed automatically.

Source Deep-Linking

When your agent cites a file from Dropbox, the source_link points to the shared Dropbox file URL.

Troubleshooting

“Unsupported file type” — Only the 7 formats listed above are indexed. Other file types are intentionally skipped.

Files not appearing after upload — New files are picked up on the next scheduled sync. Trigger a manual sync from the Connectors page if you need immediate indexing.

More troubleshooting

Last updated on