Dropbox
Browse, search, read, write and share the files in a connected Dropbox account.
Connect a Dropbox account to work with its files: list a folder or a whole subtree, search by name or by what a document says, read a file out as an attachment on the session, write one in from the workspace, create folders, move and rename, delete to the trash, and mint a shared link. Acts as the signed-in account itself, so it reaches exactly what that account reaches - no Dropbox Business team-admin access is requested or possible.
Connect
Sign in with Dropbox. Sign in with Dropbox to browse, read, write and share the files in your Dropbox. An organization admin configures the OAuth app once under Integrations → OAuth apps; after that, connecting is a consent screen.
-
Connecting signs in as YOU - every tool reaches exactly the files your Dropbox account reaches, and a file it writes is written by you.
-
The app asks for your files' metadata, their contents, and permission to create shared links. It does NOT ask for any Dropbox Business team-admin scope, so it can never reach a colleague's files that aren't shared with you.
-
Delete moves a file to your Dropbox trash, where you can restore it. The permanent-delete scope is deliberately not requested.
-
For scheduled or triggered automations, connect a dedicated Dropbox account and share the folders it should reach with it: automations cannot run as whoever happened to start them, so they need a service connection.
Tools
| Tool | Access | What it does |
|---|---|---|
Get current account (yekar.dropbox.get-current-account) | Read | Read the connected Dropbox account: display name, email, account id. Use it to confirm WHICH account this connection acts as before writing anything - every tool here acts as that account, and a connection made with a personal account instead of the work one looks identical until a path 404s. |
List folder (yekar.dropbox.list-folder) | Read | List the files and folders directly inside a Dropbox folder (or the whole subtree with recursive). Returns ids and paths the other tools take. Paginated - Dropbox reports no total, so what comes back is a page, not a count of what is there. |
Search files (yekar.dropbox.search) | Read | Find files and folders in the connected Dropbox by name, or by what a document says. Returns ids and paths the other tools take. Paginated - Dropbox reports no total for a search, so what comes back is a page, not a count of the matches that exist. |
Get file or folder (yekar.dropbox.get-metadata) | Read | Read one file or folder's details: its id, size, revision and when it last changed. Use it to confirm a path exists and is what you think it is before downloading or overwriting it. |
Download file (yekar.dropbox.download-file) | Read | Fetch a file's contents from Dropbox and save it as an attachment on this session, rather than returning the bytes inline. Works for any file type. Files over 100 MB are refused in one call. A Dropbox Paper doc is not a file and cannot be downloaded this way. |
Upload file (yekar.dropbox.upload-file) | Write | Write a file into Dropbox from this run's workspace or an https URL. The path includes the file name. Files over 150 MB are refused - Dropbox needs its chunked upload session for those and this integration does not implement one. |
Create folder (yekar.dropbox.create-folder) | Write | Create a folder in Dropbox. Parent folders are created as needed. With autorename off, a path that already exists fails rather than being silently reused. |
Move or rename (yekar.dropbox.move) | Write | Move a file or folder to a new path, which is also how you rename one - the destination is the full path including the name. Moving a folder moves everything inside it. |
Delete file or folder (yekar.dropbox.delete) | Write | Move a file or folder to the connected account's Dropbox trash, where the owner can restore it. Deleting a folder deletes everything inside it. This integration cannot permanently delete anything - the Dropbox scope that would allow it is deliberately not requested. |
Create shared link (yekar.dropbox.create-shared-link) | Write | Mint a Dropbox shared link for a file or folder and return its URL. A link that already exists for the path is RETURNED rather than replaced (the result says so via reused), because Dropbox refuses a second link and the existing one's settings may not be the ones you asked for. Check visibility on the result before treating a link as public: a Dropbox Business team can force every link to team-only. |
Notes
- Sign in with Dropbox to connect - every tool acts as YOUR account, and a file it writes or deletes is written or deleted by you.
- Dropbox paths are absolute and start with a slash ("/Reports/q3.pdf"); the root folder is an empty path, not "/". List folder and Search files return ids too, and an id survives a rename where a path does not.
- Delete moves a file to your Dropbox trash, where you can restore it - nothing here deletes permanently.
- Upload takes the destination path INCLUDING the file name, and refuses to overwrite unless you ask for mode 'overwrite'.
- A shared link that already exists is returned rather than replaced, and it comes back marked
reused- its settings are whatever they already were, so checkvisibilitybefore telling anyone the link is public. - For a schedule or a trigger, bind this as a service connection owned by a dedicated Dropbox account with the relevant folders shared to it - an automation cannot run as whoever happened to start it.
- Anyone who can drop a file into a shared folder can write text your agent will read. Gate write and share steps in any automation whose reads come from a folder outsiders can add to.