Manage files and folders with Dropbox cloud storage including upload, download, organization, and search
The Dropbox API allows you to manage files and folders in your cloud storage. You can upload and download files, create and organize folders, search for content, move files and folders, retrieve metadata, and handle all aspects of your file storage and organization with comprehensive cloud storage management.
Required:
action
- The action to perform (upload, download, list, create, move, search, delete)entity
- The entity type (file, folder)path
- File or folder pathOptional:
mode
- Upload mode (add, overwrite, update)autorename
- Automatically rename if conflict existsrecursive
- Include subfolders in listingquery
- Search query stringmax_results
- Maximum number of search resultsinclude_media_info
- Include media metadataUpload a file to Dropbox at the specified path.
Parameters:
path
(required) - Destination path for the filemode
(optional) - Upload mode: add, overwrite, update (default: add)autorename
(optional) - Automatically rename if file exists (default: true)mute
(optional) - Suppress notifications (default: false)strict_conflict
(optional) - Strict conflict detection (default: false)Example:
Response:
Download a file from Dropbox by specifying its path.
Parameters:
path
(required) - Path to the file to downloadExample:
Response:
List the contents of a folder in Dropbox.
Parameters:
path
(required) - Path to the folder to listrecursive
(optional) - Include subfolders recursively (default: false)include_media_info
(optional) - Include media metadata (default: false)include_deleted
(optional) - Include deleted files (default: false)include_mounted_folders
(optional) - Include mounted folders (default: true)Example:
Response:
Create a new folder in Dropbox.
Parameters:
path
(required) - Path for the new folderautorename
(optional) - Automatically rename if folder exists (default: false)Example:
Response:
Move a folder to a new location in Dropbox.
Parameters:
from_path
(required) - Current path of the folderto_path
(required) - New path for the folderallow_shared_folder
(optional) - Allow moving shared folders (default: false)autorename
(optional) - Automatically rename if conflict exists (default: false)allow_ownership_transfer
(optional) - Allow ownership transfer (default: false)Example:
Response:
Retrieve metadata for a folder using its ID or path.
Parameters:
path
(required) - Path or ID of the folderinclude_media_info
(optional) - Include media metadata (default: false)include_deleted
(optional) - Include deleted status (default: false)include_has_explicit_shared_members
(optional) - Include sharing info (default: false)Example:
Response:
Search for folders in Dropbox matching a query.
Parameters:
query
(required) - Search query stringpath
(optional) - Path to search within (default: entire account)max_results
(optional) - Maximum number of results (default: 20)file_status
(optional) - File status filter: active, deleted (default: active)filename_only
(optional) - Search filename only (default: false)Example:
Response:
Delete a folder in Dropbox using its path.
Parameters:
path
(required) - Path of the folder to deleteExample:
Response:
Upload modes include add (fail if exists), overwrite (replace existing), and update (modify existing). Autorename automatically adds number suffix to avoid conflicts. File paths are case-insensitive but preserve display case. IDs start with “id:” prefix for unique identification. Tags indicate entry type: file or folder. Recursive listing includes all subfolders and files. Search supports filename and content matching. File revisions track version history. Client_modified reflects original file timestamp while server_modified shows upload time. Supports both PinkConnect and Paragon proxy connections. Content hashing ensures file integrity. Sharing information available for collaborative folders.