Skip to main content

​
Connecting Dropbox

1

Open the Dropbox panel

In the Vault, click the Dropbox tab in the sidebar, or use + New, then Import from Dropbox.
2

Click Connect Dropbox

You see: “Browse, import, and sync files directly from your Dropbox account into this vault.” Click the button.
3

Grant permissions

You are redirected to Dropbox OAuth. Approve read access to your files. Required scopes: account_info.read, files.metadata.read, files.content.read.
4

Verify connection

The panel shows your connected account email with a green “Connected” label and a file browser.
Dropbox panel

​
Browsing Your Dropbox

Once connected, the panel shows a full file browser:
ElementDescription
BreadcrumbsNavigate up the folder tree
Back buttonGo to parent folder
RefreshReload current folder contents
Sync this folderSet up sync for the current folder
Select all filesToggle selection for all files in view
Folder itemsClick to navigate into the folder
File itemsClick to select for import; “Open in Dropbox” link

​
File Icons

Files display with color-coded icons based on type:
  • Images (jpg, jpeg, png, gif, webp, svg) — Purple
  • Documents (pdf, doc, docx, txt, md) — Blue
  • Other files — Gray

​
Pagination

The browser auto-paginates Dropbox results (up to 2,000 entries on initial load). For larger folders, cursor-based pagination loads additional batches.

​
Importing Files (One-Time)

1

Browse to your files

Navigate through your Dropbox folders.
2

Select files

Click individual files or use “Select all files” to select everything in the current view. Selected files show a blue highlight.
3

Click Import to vault

A footer bar shows “X file(s) selected” with an Import to vault button.
4

Files are downloaded and uploaded

Each file is downloaded from Dropbox (using a temporary download link) and uploaded to the current vault. Toast confirms: “N file(s) imported”

​
Setting Up Folder Sync

Folder sync creates an ongoing link between a Dropbox folder and a vault.
1

Navigate to the folder

Browse to the Dropbox folder you want to sync.
2

Click Sync this folder

A sync dialog opens.
3

Choose target vault

Select which vault to sync into from the dropdown: Default, Sales, Science, Marketing, or any custom vault.
4

Click Sync Now

The sync runs as a background task. You see a toast: “Adding and syncing…” You do not need to keep the page open.

​
What Sync Does

  • Downloads all files from the Dropbox folder recursively
  • Creates a matching folder structure in your target vault
  • Files are automatically indexed for Brain AI search
  • The synced folder appears in the “Synced Folders” list with a vault badge (e.g., “Sales”)

​
Re-syncing

To pull new files added since the last sync:
  1. Find the folder in the Synced Folders list
  2. Click the re-sync button
  3. New and modified files are downloaded and added

​
Removing a Sync

Click the trash icon on any synced folder to remove the sync relationship. This does not delete files already imported into the vault. Toast confirms: “Folder removed”

​
Synced Folders List

The top of the Dropbox panel shows all synced folders with:
ColumnDescription
Folder nameThe Dropbox folder path
Vault badgeWhich vault it syncs to (e.g., “Sales”)
Last syncedWhen the last sync completed
File countNumber of files in the sync
Synced folder with vault badge

​
Downloading Files

While browsing your Dropbox, you can download any file directly by clicking the download button next to it. This downloads from Dropbox without importing into the vault.

​
Disconnecting

Click Disconnect in the panel header to remove your Dropbox connection. This:
  • Removes your OAuth tokens
  • Does not delete files already imported into vaults
  • Does not remove synced folder configurations (they become inactive)
Toast confirms: “Dropbox disconnected”

​
Troubleshooting

​
”Invalid client_id” Error

Ensure your Dropbox app has the correct scopes enabled:
  • account_info.read
  • files.metadata.read
  • files.content.read
Also verify your redirect URI includes your domain (e.g., https://www.ospribrain.com/api/dropbox/callback).

​
Sync Not Completing

  • Syncs run in the background — wait a few minutes for large folders
  • Check the Synced Folders list for status updates
  • Try clicking re-sync on the folder

​
”Navigate into a folder first”

You need to be inside a folder (not at the Dropbox root) to set up sync. Click into a specific folder first.