Overview
Add Dropbox to any ModuleX agent or workflow. Cloud file storage, sharing, and collaboration via the Dropbox HTTP API (api.dropboxapi.com/2).
Categories: Cloud Infrastructure · Productivity & Collaboration · File Storage · Cloud Storage · Auth: OAuth2 · Actions: 12
Authentication
OAuth2 Authentication
Connect using Dropbox OAuth (recommended)Required Credentials
| Field | Description | Required | Format |
|---|---|---|---|
| Client ID | Dropbox OAuth App Client ID | Yes | xxxxxxxxxxxxxxx |
| Client Secret | Dropbox OAuth App Client Secret | Yes | xxxxxxxxxxxxxxx |
OAuth Configuration
- Authorization URL:
https://www.dropbox.com/oauth2/authorize - Token URL:
https://api.dropboxapi.com/oauth2/token - Scopes:
files.metadata.read,files.metadata.write,files.content.read,files.content.write,sharing.read,sharing.write,account_info.read
Available Actions
create_folder — Create a new folder in the user's Dropbox
create_folder — Create a new folder in the user's Dropbox
Parameters
string
required
The new folder name
string
Parent folder path where the new folder will be created (empty string for root) (Default: “)
boolean
If true, Dropbox will autorename the folder if there is a conflict (Default:
true)Response
{
"$defs": {
"FileMetadata": {
"additionalProperties": false,
"description": "Metadata for a file or folder returned by the Dropbox API.",
"properties": {
".tag": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": ".Tag"
},
"name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Name"
},
"id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Id"
},
"path_display": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Path Display"
},
"path_lower": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Path Lower"
},
"size": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Size"
},
"rev": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Rev"
},
"content_hash": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Content Hash"
},
"server_modified": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Server Modified"
},
"client_modified": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Client Modified"
},
"is_downloadable": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"default": null,
"title": "Is Downloadable"
}
},
"title": "FileMetadata",
"type": "object"
}
},
"additionalProperties": false,
"properties": {
"success": {
"title": "Success",
"type": "boolean"
},
"error": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Error"
},
"metadata": {
"anyOf": [
{
"$ref": "#/$defs/FileMetadata"
},
{
"type": "null"
}
],
"default": null
}
},
"required": [
"success"
],
"title": "CreateFolderOutput",
"type": "object"
}
search_files_folders — Search for files and folders by name or content
search_files_folders — Search for files and folders by name or content
Parameters
string
required
The search query string
string
Folder path to restrict the search to (empty string for all) (Default: “)
string
Sort order: relevance, last_modified_time
string
Restrict to file status: active, deleted
boolean
If true, restricts search to filenames only
integer
Maximum number of results to return (defaults to 100)
Response
{
"$defs": {
"FileMetadata": {
"additionalProperties": false,
"description": "Metadata for a file or folder returned by the Dropbox API.",
"properties": {
".tag": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": ".Tag"
},
"name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Name"
},
"id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Id"
},
"path_display": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Path Display"
},
"path_lower": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Path Lower"
},
"size": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Size"
},
"rev": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Rev"
},
"content_hash": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Content Hash"
},
"server_modified": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Server Modified"
},
"client_modified": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Client Modified"
},
"is_downloadable": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"default": null,
"title": "Is Downloadable"
}
},
"title": "FileMetadata",
"type": "object"
},
"SearchMatch": {
"additionalProperties": false,
"description": "A single search result match.",
"properties": {
"match_type": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Match Type"
},
"metadata": {
"anyOf": [
{
"$ref": "#/$defs/FileMetadata"
},
{
"type": "null"
}
],
"default": null
}
},
"title": "SearchMatch",
"type": "object"
}
},
"additionalProperties": false,
"properties": {
"success": {
"title": "Success",
"type": "boolean"
},
"error": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Error"
},
"matches": {
"items": {
"$ref": "#/$defs/SearchMatch"
},
"title": "Matches",
"type": "array"
},
"has_more": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"default": null,
"title": "Has More"
}
},
"required": [
"success"
],
"title": "SearchFileFoldersOutput",
"type": "object"
}
list_file_folders_in_a_folder — List all files and subfolders in a specified folder
list_file_folders_in_a_folder — List all files and subfolders in a specified folder
Parameters
string
required
The folder path to list contents of (empty string for root)
boolean
If true, list contents of all subfolders recursively (Default:
true)boolean
If true, include files and folders that were deleted (Default:
false)boolean
If true, include entries under mounted folders (app, shared, team) (Default:
false)boolean
If true, include non-downloadable files like Google Docs (Default:
true)integer
Maximum number of entries to return (defaults to 100)
Response
{
"$defs": {
"FileMetadata": {
"additionalProperties": false,
"description": "Metadata for a file or folder returned by the Dropbox API.",
"properties": {
".tag": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": ".Tag"
},
"name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Name"
},
"id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Id"
},
"path_display": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Path Display"
},
"path_lower": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Path Lower"
},
"size": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Size"
},
"rev": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Rev"
},
"content_hash": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Content Hash"
},
"server_modified": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Server Modified"
},
"client_modified": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Client Modified"
},
"is_downloadable": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"default": null,
"title": "Is Downloadable"
}
},
"title": "FileMetadata",
"type": "object"
}
},
"additionalProperties": false,
"properties": {
"success": {
"title": "Success",
"type": "boolean"
},
"error": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Error"
},
"entries": {
"items": {
"$ref": "#/$defs/FileMetadata"
},
"title": "Entries",
"type": "array"
},
"has_more": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"default": null,
"title": "Has More"
}
},
"required": [
"success"
],
"title": "ListFileFoldersOutput",
"type": "object"
}
delete_file_folder — Permanently delete a file or folder from Dropbox
delete_file_folder — Permanently delete a file or folder from Dropbox
Parameters
string
required
Path of the file or folder to delete
Response
{
"$defs": {
"FileMetadata": {
"additionalProperties": false,
"description": "Metadata for a file or folder returned by the Dropbox API.",
"properties": {
".tag": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": ".Tag"
},
"name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Name"
},
"id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Id"
},
"path_display": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Path Display"
},
"path_lower": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Path Lower"
},
"size": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Size"
},
"rev": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Rev"
},
"content_hash": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Content Hash"
},
"server_modified": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Server Modified"
},
"client_modified": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Client Modified"
},
"is_downloadable": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"default": null,
"title": "Is Downloadable"
}
},
"title": "FileMetadata",
"type": "object"
}
},
"additionalProperties": false,
"properties": {
"success": {
"title": "Success",
"type": "boolean"
},
"error": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Error"
},
"metadata": {
"anyOf": [
{
"$ref": "#/$defs/FileMetadata"
},
{
"type": "null"
}
],
"default": null
}
},
"required": [
"success"
],
"title": "DeleteFileFolderOutput",
"type": "object"
}
move_file_folder — Move a file or folder to a different location in Dropbox
move_file_folder — Move a file or folder to a different location in Dropbox
Parameters
string
required
Path of the file or folder to move
string
required
Destination folder path (file name is appended automatically)
boolean
If true, autorename to avoid conflicts (Default:
false)boolean
Allow moves that result in ownership transfer (Default:
false)Response
{
"$defs": {
"FileMetadata": {
"additionalProperties": false,
"description": "Metadata for a file or folder returned by the Dropbox API.",
"properties": {
".tag": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": ".Tag"
},
"name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Name"
},
"id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Id"
},
"path_display": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Path Display"
},
"path_lower": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Path Lower"
},
"size": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Size"
},
"rev": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Rev"
},
"content_hash": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Content Hash"
},
"server_modified": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Server Modified"
},
"client_modified": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Client Modified"
},
"is_downloadable": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"default": null,
"title": "Is Downloadable"
}
},
"title": "FileMetadata",
"type": "object"
}
},
"additionalProperties": false,
"properties": {
"success": {
"title": "Success",
"type": "boolean"
},
"error": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Error"
},
"metadata": {
"anyOf": [
{
"$ref": "#/$defs/FileMetadata"
},
{
"type": "null"
}
],
"default": null
}
},
"required": [
"success"
],
"title": "MoveFileFolderOutput",
"type": "object"
}
rename_file_folder — Rename a file or folder in Dropbox
rename_file_folder — Rename a file or folder in Dropbox
Parameters
string
required
Path of the file or folder to rename
string
required
The new name (include file extension for files)
boolean
If true, autorename to avoid conflicts (Default:
false)boolean
Allow renames that result in ownership transfer (Default:
false)Response
{
"$defs": {
"FileMetadata": {
"additionalProperties": false,
"description": "Metadata for a file or folder returned by the Dropbox API.",
"properties": {
".tag": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": ".Tag"
},
"name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Name"
},
"id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Id"
},
"path_display": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Path Display"
},
"path_lower": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Path Lower"
},
"size": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Size"
},
"rev": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Rev"
},
"content_hash": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Content Hash"
},
"server_modified": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Server Modified"
},
"client_modified": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Client Modified"
},
"is_downloadable": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"default": null,
"title": "Is Downloadable"
}
},
"title": "FileMetadata",
"type": "object"
}
},
"additionalProperties": false,
"properties": {
"success": {
"title": "Success",
"type": "boolean"
},
"error": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Error"
},
"metadata": {
"anyOf": [
{
"$ref": "#/$defs/FileMetadata"
},
{
"type": "null"
}
],
"default": null
}
},
"required": [
"success"
],
"title": "RenameFileFolderOutput",
"type": "object"
}
create_a_text_file — Create a new text file from plain text content
create_a_text_file — Create a new text file from plain text content
Parameters
string
required
File name including extension (e.g. notes.txt)
string
Folder path where the file will be created (empty string for root) (Default: “)
string
required
The text content of the new file
Response
{
"additionalProperties": false,
"properties": {
"success": {
"title": "Success",
"type": "boolean"
},
"error": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Error"
},
"name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Name"
},
"id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Id"
},
"path_display": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Path Display"
},
"size": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Size"
},
"rev": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Rev"
},
"content_hash": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Content Hash"
}
},
"required": [
"success"
],
"title": "CreateTextFileOutput",
"type": "object"
}
create_or_append_to_a_text_file — Append a line to an existing text file, or create the file if it does not exist
create_or_append_to_a_text_file — Append a line to an existing text file, or create the file if it does not exist
Parameters
string
required
File name including extension
string
Folder path (empty string for root) (Default: “)
string
required
The text content to write or append
Response
{
"additionalProperties": false,
"properties": {
"success": {
"title": "Success",
"type": "boolean"
},
"error": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Error"
},
"name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Name"
},
"id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Id"
},
"path_display": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Path Display"
},
"size": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Size"
},
"rev": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Rev"
},
"content_hash": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Content Hash"
}
},
"required": [
"success"
],
"title": "CreateOrAppendToTextFileOutput",
"type": "object"
}
create_update_share_link — Create or update a public share link for a file or folder
create_update_share_link — Create or update a public share link for a file or folder
Parameters
string
required
Path of the file or folder to share
boolean
Enable password protection on the shared link (Default:
false)string
Password for the shared link (if require_password is true)
string
Expiration timestamp in ISO 8601 format (e.g. 2024-07-18T20:00:00Z)
string
Link audience: public, team, no_one
Response
{
"additionalProperties": false,
"properties": {
"success": {
"title": "Success",
"type": "boolean"
},
"error": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Error"
},
"url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Url"
},
"name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Name"
},
"path_lower": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Path Lower"
},
"link_permissions": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"default": null,
"title": "Link Permissions"
}
},
"required": [
"success"
],
"title": "CreateUpdateShareLinkOutput",
"type": "object"
}
list_shared_links — List shared links for a file or folder path
list_shared_links — List shared links for a file or folder path
Parameters
string
File or folder path to list shared links for (optional, lists all if empty)
Response
{
"$defs": {
"SharedLinkInfo": {
"additionalProperties": false,
"description": "Metadata for a shared link.",
"properties": {
"url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Url"
},
"name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Name"
},
"path_lower": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Path Lower"
},
"id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Id"
},
"expires": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Expires"
},
"link_permissions": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"default": null,
"title": "Link Permissions"
}
},
"title": "SharedLinkInfo",
"type": "object"
}
},
"additionalProperties": false,
"properties": {
"success": {
"title": "Success",
"type": "boolean"
},
"error": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Error"
},
"links": {
"items": {
"$ref": "#/$defs/SharedLinkInfo"
},
"title": "Links",
"type": "array"
}
},
"required": [
"success"
],
"title": "ListSharedLinksOutput",
"type": "object"
}
get_shared_link_metadata — Get metadata for a shared link URL
get_shared_link_metadata — Get metadata for a shared link URL
Parameters
string
required
The URL of the shared link
string
Password if the shared link is password-protected
Response
{
"additionalProperties": false,
"properties": {
"success": {
"title": "Success",
"type": "boolean"
},
"error": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Error"
},
"url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Url"
},
"name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Name"
},
"path_lower": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Path Lower"
},
"id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Id"
},
"link_permissions": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"default": null,
"title": "Link Permissions"
}
},
"required": [
"success"
],
"title": "GetSharedLinkMetadataOutput",
"type": "object"
}
list_file_revisions — List revision history for a file
list_file_revisions — List revision history for a file
Parameters
string
required
The file path to list revisions for
string
Revision mode: path (default, revisions at same path) or id (revisions with same file id)
integer
Maximum number of revision entries to return
Response
{
"$defs": {
"FileMetadata": {
"additionalProperties": false,
"description": "Metadata for a file or folder returned by the Dropbox API.",
"properties": {
".tag": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": ".Tag"
},
"name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Name"
},
"id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Id"
},
"path_display": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Path Display"
},
"path_lower": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Path Lower"
},
"size": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Size"
},
"rev": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Rev"
},
"content_hash": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Content Hash"
},
"server_modified": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Server Modified"
},
"client_modified": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Client Modified"
},
"is_downloadable": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"default": null,
"title": "Is Downloadable"
}
},
"title": "FileMetadata",
"type": "object"
}
},
"additionalProperties": false,
"properties": {
"success": {
"title": "Success",
"type": "boolean"
},
"error": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Error"
},
"entries": {
"items": {
"$ref": "#/$defs/FileMetadata"
},
"title": "Entries",
"type": "array"
},
"is_deleted": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"default": null,
"title": "Is Deleted"
}
},
"required": [
"success"
],
"title": "ListFileRevisionsOutput",
"type": "object"
}
Limits & Quotas
- Rate limits: Dropbox applies per-app and per-user rate limits. Individual apps are limited to approximately 25,000 HTTP requests per month for free-tier apps and higher for production apps.
- List folder: Maximum 2,000 entries per single request (pagination via cursor for more).
- File upload: Maximum 150 MB per single upload request (content upload endpoint).
- Error model: Non-2xx responses are caught and returned as
success=False+errorrather than raising. Plan for retries on 429 (rate limit) responses.