Skip to main content

Dropbox

Comprehensive Dropbox connector for managing files, folders, sharing, and collaboration in cloud storage.

Categories: Cloud Storage, File Sharing, Collaboration

What you can ask​

  • Find every file in /Sales/Proposals modified in the last 7 days.
  • Share the Customer Onboarding folder with view-only access to onboarding@acme.com.
  • Move all files older than 1 year from /Active to /Archive.

Set up​

Dropbox is ready to enable, and an admin doesn't need to create anything first.

  1. Go to Organization > Connectors and find Dropbox.
  2. Click Enable and choose which tools to allow.
  3. Each member connects their own account the first time they use it.

To use one account for the whole organization, turn on Share one connection with everyone. Every member's agents then act as that account, with exactly the access it has.

You can also use your own OAuth application instead of the shared one. Create it in the Dropbox developer portal, then enter its details under Use your own OAuth application.

Tools​

Dropbox offers 33 tools. Admins choose which ones agents can use. See Tool permission groups.

Read (18)​

View and search information without changing it.

ToolWhat it does
get_accountGet detailed account information for a specific Dropbox user by account ID
get_account_batchGet account information for multiple Dropbox users in a single batch request
get_current_accountGet detailed information about the currently authenticated Dropbox user account
get_file_contentRead a Dropbox file's text (up to 25 MB): PDF, Word, Excel, PowerPoint, Paper, txt, markdown, csv, json.
get_file_metadataGet metadata for a file or folder: size, timestamps, rev, content hash.
get_shared_folder_metadataGet details for one shared folder by its shared_folder_id, including name, path and this account's access level.
get_shared_link_metadataGet metadata for a Dropbox share link URL: the linked item's name, size, and path_lower when it lives in this account.
get_space_usageGet current storage space usage and allocation for the authenticated user account
get_temporary_linkGenerate a temporary download link for a file that expires after 4 hours.
list_file_revisionsList all saved revisions of a file for version history and recovery.
list_folderList a Dropbox folder's contents, with recursive listing and cursor pagination.
list_folder_continueContinue paginating through folder contents using cursor from previous list_folder response
list_folder_membersList the members, groups and pending invitations of a shared folder.
list_shared_foldersList the folders shared with or by this account, with the shared_folder_id each one needs.
list_shared_linksList all shared links created by the user with optional path filtering and pagination
search_continueContinue paginating through search results using cursor from previous search
search_filesSearch for files and folders in Dropbox by filename or content with advanced filtering. query is required and must be non-empty; to browse a folder without a search term use list_folder instead.
validate_credentialValidate Dropbox credentials.

Write (6)​

Create or send data.

ToolWhat it does
add_folder_memberAdd members to a shared folder with the given access level and an optional message.
copy_file_or_folderCopy a file or folder to a new location within Dropbox, preserving metadata.
create_folderCreate a new folder at the specified path in Dropbox with auto-rename support.
create_shared_linkCreate a shareable link for a file or folder with customizable access settings and expiration
mount_shared_folderMount a shared folder so it appears in this account's Dropbox file system.
upload_fileUpload a file to Dropbox.

Delete or overwrite (9)​

Remove or replace existing data.

ToolWhat it does
delete_file_or_folderDelete a file or folder from Dropbox, moving it to trash for recovery.
move_file_or_folderMove or rename a file or folder to a new path within Dropbox.
remove_folder_memberRemove a member's access to a shared folder, optionally leaving them a copy.
restore_file_revisionRestore a file to a specific previous revision from version history.
revoke_shared_linkRevoke an existing shared link to immediately disable access via that URL
share_folderShare a folder with team members or anyone, enabling collaboration with access control
unmount_shared_folderUnmount a shared folder, removing it from this account's file system without losing access.
unshare_folderStop sharing a folder and optionally leave existing members a copy.
update_folder_memberChange an existing member's access level on a shared folder (owner, editor, viewer, viewer_no_comment or traverse).
⌘J