Dropbox Connector
Sync files from your Dropbox folders into Knowledge Raven.
What Gets Synced
Knowledge Raven supports the following file formats from Dropbox:
| Format | Max 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.