Dropbox
Connects to the Dropbox API for browsing and managing files. An agent can list folder contents, search for files, read metadata, create folders, and copy files.
Add to an agent node's tools array with _node_type: "tool-dropbox". See Connector Reference — How connectors are used.
Authentication
| Field | Required | Description |
|---|---|---|
access_token | Yes | Dropbox API access token, sent as Authorization: Bearer <token>. Typically populated from a stored OAuth connection via oauth_connection_id, or a stored secret. |
{
"name": "dropbox",
"_node_type": "tool-dropbox",
"oauth_connection_id": "{{ connections.dropbox }}"
}
Tools
dropbox_list_folder
List files and folders in a Dropbox directory.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
path | string | No | Folder path (e.g. /Documents or empty string for root) |
limit | number | No | Max entries (default 20) |
Returns: A list of entries — folders shown as 📁 **<name>** (<path>), files shown as 📄 **<name>** (<size> bytes | <modified date>) <path> — or "Folder is empty.".
dropbox_search
Search for files and folders in Dropbox.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
query | string | Yes | Search query |
limit | number | No | Max results (default 10) |
path | string | No | Restrict search to this folder path |
Returns: A list of matches as 📄/📁 **<name>** (<path>) lines, or "No files found.".
dropbox_get_file_metadata
Get metadata for a specific Dropbox file.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
path | string | Yes | Full file path (e.g. /Documents/report.pdf) |
Returns: A text block with the file name, path, size in bytes, last modified time, and revision ID.
dropbox_create_folder
Create a new folder in Dropbox.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
path | string | Yes | Path for the new folder (e.g. /Documents/NewFolder) |
Returns: "Folder created at **<path>**".
dropbox_copy_file
Copy a file or folder in Dropbox.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
from_path | string | Yes | Source file path |
to_path | string | Yes | Destination path |
Returns: "**<name>** copied to <path>".