> ## Documentation Index
> Fetch the complete documentation index at: https://docs.pinkfish.ai/llms.txt
> Use this file to discover all available pages before exploring further.
# dropbox
> Files, folders, and sharing
**Server path:** `/dropbox` | **Type:** Application | **PCID required:** Yes
## Tools
| Tool | Description |
| ----------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| [`dropbox_upload_file`](#dropbox_upload_file) | Upload a file to Dropbox. Provide either fileUrl (to upload from a URL) or content (base64 encoded or plain text), but not both. |
| [`dropbox_download_file`](#dropbox_download_file) | Download a file from Dropbox. IN WORKFLOWS: Files are automatically saved to Node Outputs - no manual save step needed. By default, automatically extracts text from supported document formats (PDF, DOCX, PPTX, XLSX) and includes it in the response. Text files (TXT, CSV) do not need extraction. STREAMING IS PREFERRED: Use stream=true (default) to get a pre-authenticated downloadUrl for efficient downloading of large files. Only use stream=false for small files (\<2MB) that need immediate processing. |
| [`dropbox_list_folder`](#dropbox_list_folder) | List contents of a Dropbox folder |
| [`dropbox_create_folder`](#dropbox_create_folder) | Create a new folder in Dropbox |
| [`dropbox_delete_file`](#dropbox_delete_file) | Delete a file or folder from Dropbox |
| [`dropbox_move_file`](#dropbox_move_file) | Move or rename a file or folder in Dropbox |
| [`dropbox_copy_file`](#dropbox_copy_file) | Copy a file or folder in Dropbox |
| [`dropbox_get_metadata`](#dropbox_get_metadata) | Get metadata for a file or folder |
| [`dropbox_search_files`](#dropbox_search_files) | Search for files and folders in Dropbox. Two search modes: (1) FUZZY SEARCH (default): Full-text search across filenames and content. (2) EXACT MATCH: Find files with an exact filename match within the specified path (direct children only, not recursive). |
| [`dropbox_create_shared_link`](#dropbox_create_shared_link) | Create a shared link for a file or folder |
| [`dropbox_get_account_info`](#dropbox_get_account_info) | Get current Dropbox account information |
| [`dropbox_get_space_usage`](#dropbox_get_space_usage) | Get Dropbox account space usage information |
***
## dropbox\_upload\_file
Upload a file to Dropbox. Provide either fileUrl (to upload from a URL) or content (base64 encoded or plain text), but not both.
**Parameters:**
| Parameter | Type | Required | Default | Description |
| ------------ | ------- | -------- | ------- | --------------------------------------------------------------------------------- |
| `path` | string | Yes | — | Destination path in Dropbox (e.g., "/folder/file.txt") |
| `content` | string | No | — | File content (base64 encoded or plain text). Required if fileUrl is not provided. |
| `fileUrl` | string | No | — | URL of the file to upload. Required if content is not provided. |
| `mode` | string | No | `"add"` | Upload mode |
| `autorename` | boolean | No | `false` | Auto-rename if file exists |
| `mute` | boolean | No | `false` | Suppress notifications |
```json theme={null}
{
"type": "object",
"properties": {
"PCID": {
"type": "string",
"description": "Pink Connect ID"
},
"path": {
"type": "string",
"description": "Destination path in Dropbox (e.g., \"/folder/file.txt\")"
},
"content": {
"type": "string",
"description": "File content (base64 encoded or plain text). Required if fileUrl is not provided."
},
"fileUrl": {
"type": "string",
"description": "URL of the file to upload. Required if content is not provided."
},
"mode": {
"type": "string",
"enum": [
"add",
"overwrite",
"update"
],
"default": "add",
"description": "Upload mode"
},
"autorename": {
"type": "boolean",
"default": false,
"description": "Auto-rename if file exists"
},
"mute": {
"type": "boolean",
"default": false,
"description": "Suppress notifications"
}
},
"required": [
"PCID",
"path"
]
}
```
***
## dropbox\_download\_file
Download a file from Dropbox. IN WORKFLOWS: Files are automatically saved to Node Outputs - no manual save step needed. By default, automatically extracts text from supported document formats (PDF, DOCX, PPTX, XLSX) and includes it in the response. Text files (TXT, CSV) do not need extraction. STREAMING IS PREFERRED: Use stream=true (default) to get a pre-authenticated downloadUrl for efficient downloading of large files. Only use stream=false for small files (\<2MB) that need immediate processing.
**Parameters:**
| Parameter | Type | Required | Default | Description |
| ------------- | ------- | -------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `path` | string | Yes | — | File path in Dropbox to download |
| `stream` | boolean | No | `true` | RECOMMENDED: true (default). Returns a pre-authenticated downloadUrl for efficient streaming. Set to false only for small files (\<2MB) requiring immediate base64 content. |
| `extractText` | boolean | No | `true` | Automatically extracts text from supported formats (PDF, DOCX, PPTX, XLSX) and includes it in the response. Text files do not need extraction. Set to false to skip extraction. |
```json theme={null}
{
"type": "object",
"properties": {
"PCID": {
"type": "string",
"description": "Pink Connect ID"
},
"path": {
"type": "string",
"description": "File path in Dropbox to download"
},
"stream": {
"type": "boolean",
"default": true,
"description": "RECOMMENDED: true (default). Returns a pre-authenticated downloadUrl for efficient streaming. Set to false only for small files (<2MB) requiring immediate base64 content."
},
"extractText": {
"type": "boolean",
"default": true,
"description": "Automatically extracts text from supported formats (PDF, DOCX, PPTX, XLSX) and includes it in the response. Text files do not need extraction. Set to false to skip extraction."
}
},
"required": [
"PCID",
"path"
]
}
```
***
## dropbox\_list\_folder
List contents of a Dropbox folder
**Parameters:**
| Parameter | Type | Required | Default | Description |
| ------------------ | ------- | -------- | ------- | ------------------------------------------- |
| `path` | string | No | `""` | Folder path to list (empty string for root) |
| `recursive` | boolean | No | `false` | List recursively through subfolders |
| `includeMediaInfo` | boolean | No | `false` | Include media metadata |
| `includeDeleted` | boolean | No | `false` | Include deleted files |
| `limit` | number | No | `2000` | Maximum number of entries to return |
```json theme={null}
{
"type": "object",
"properties": {
"PCID": {
"type": "string",
"description": "Pink Connect ID"
},
"path": {
"type": "string",
"default": "",
"description": "Folder path to list (empty string for root)"
},
"recursive": {
"type": "boolean",
"default": false,
"description": "List recursively through subfolders"
},
"includeMediaInfo": {
"type": "boolean",
"default": false,
"description": "Include media metadata"
},
"includeDeleted": {
"type": "boolean",
"default": false,
"description": "Include deleted files"
},
"limit": {
"type": "number",
"default": 2000,
"description": "Maximum number of entries to return"
}
},
"required": [
"PCID"
]
}
```
***
## dropbox\_create\_folder
Create a new folder in Dropbox
**Parameters:**
| Parameter | Type | Required | Default | Description |
| ------------ | ------- | -------- | ------- | --------------------------------------------- |
| `path` | string | Yes | — | Path for the new folder (e.g., "/new-folder") |
| `autorename` | boolean | No | `false` | Auto-rename if folder exists |
```json theme={null}
{
"type": "object",
"properties": {
"PCID": {
"type": "string",
"description": "Pink Connect ID"
},
"path": {
"type": "string",
"description": "Path for the new folder (e.g., \"/new-folder\")"
},
"autorename": {
"type": "boolean",
"default": false,
"description": "Auto-rename if folder exists"
}
},
"required": [
"PCID",
"path"
]
}
```
***
## dropbox\_delete\_file
Delete a file or folder from Dropbox
**Parameters:**
| Parameter | Type | Required | Default | Description |
| --------- | ------ | -------- | ------- | -------------------------------- |
| `path` | string | Yes | — | Path of file or folder to delete |
```json theme={null}
{
"type": "object",
"properties": {
"PCID": {
"type": "string",
"description": "Pink Connect ID"
},
"path": {
"type": "string",
"description": "Path of file or folder to delete"
}
},
"required": [
"PCID",
"path"
]
}
```
***
## dropbox\_move\_file
Move or rename a file or folder in Dropbox
**Parameters:**
| Parameter | Type | Required | Default | Description |
| ------------------- | ------- | -------- | ------- | --------------------------------- |
| `fromPath` | string | Yes | — | Current path of file or folder |
| `toPath` | string | Yes | — | New path for file or folder |
| `allowSharedFolder` | boolean | No | `false` | Allow moving shared folders |
| `autorename` | boolean | No | `false` | Auto-rename if destination exists |
```json theme={null}
{
"type": "object",
"properties": {
"PCID": {
"type": "string",
"description": "Pink Connect ID"
},
"fromPath": {
"type": "string",
"description": "Current path of file or folder"
},
"toPath": {
"type": "string",
"description": "New path for file or folder"
},
"allowSharedFolder": {
"type": "boolean",
"default": false,
"description": "Allow moving shared folders"
},
"autorename": {
"type": "boolean",
"default": false,
"description": "Auto-rename if destination exists"
}
},
"required": [
"PCID",
"fromPath",
"toPath"
]
}
```
***
## dropbox\_copy\_file
Copy a file or folder in Dropbox
**Parameters:**
| Parameter | Type | Required | Default | Description |
| ------------------- | ------- | -------- | ------- | --------------------------------- |
| `fromPath` | string | Yes | — | Source path of file or folder |
| `toPath` | string | Yes | — | Destination path for copy |
| `allowSharedFolder` | boolean | No | `false` | Allow copying shared folders |
| `autorename` | boolean | No | `false` | Auto-rename if destination exists |
```json theme={null}
{
"type": "object",
"properties": {
"PCID": {
"type": "string",
"description": "Pink Connect ID"
},
"fromPath": {
"type": "string",
"description": "Source path of file or folder"
},
"toPath": {
"type": "string",
"description": "Destination path for copy"
},
"allowSharedFolder": {
"type": "boolean",
"default": false,
"description": "Allow copying shared folders"
},
"autorename": {
"type": "boolean",
"default": false,
"description": "Auto-rename if destination exists"
}
},
"required": [
"PCID",
"fromPath",
"toPath"
]
}
```
***
## dropbox\_get\_metadata
Get metadata for a file or folder
**Parameters:**
| Parameter | Type | Required | Default | Description |
| ------------------ | ------- | -------- | ------- | ------------------------------------------ |
| `path` | string | Yes | — | Path of file or folder to get metadata for |
| `includeMediaInfo` | boolean | No | `false` | Include media metadata |
| `includeDeleted` | boolean | No | `false` | Include deleted file info |
```json theme={null}
{
"type": "object",
"properties": {
"PCID": {
"type": "string",
"description": "Pink Connect ID"
},
"path": {
"type": "string",
"description": "Path of file or folder to get metadata for"
},
"includeMediaInfo": {
"type": "boolean",
"default": false,
"description": "Include media metadata"
},
"includeDeleted": {
"type": "boolean",
"default": false,
"description": "Include deleted file info"
}
},
"required": [
"PCID",
"path"
]
}
```
***
## dropbox\_search\_files
Search for files and folders in Dropbox. Two search modes: (1) FUZZY SEARCH (default): Full-text search across filenames and content. (2) EXACT MATCH: Find files with an exact filename match within the specified path (direct children only, not recursive).
**Parameters:**
| Parameter | Type | Required | Default | Description |
| ---------------- | --------- | -------- | ------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `query` | string | Yes | — | Search query - for fuzzy search this matches filenames and content; for exact match this must be the exact filename |
| `path` | string | No | `""` | Folder path to search within (e.g., "/Documents"). Empty string means root. |
| `exactMatch` | boolean | No | `false` | If true, find files with exact filename match (only searches direct children of path, not recursive). If false (default), performs fuzzy full-text search. |
| `maxResults` | number | No | `100` | Maximum number of results |
| `fileExtensions` | string\[] | No | — | Filter by file extensions (e.g., \["pdf", "docx"]) |
| `fileCategories` | string\[] | No | — | Filter by categories (e.g., \["image", "document"]) |
```json theme={null}
{
"type": "object",
"properties": {
"PCID": {
"type": "string",
"description": "Pink Connect ID"
},
"query": {
"type": "string",
"description": "Search query - for fuzzy search this matches filenames and content; for exact match this must be the exact filename"
},
"path": {
"type": "string",
"default": "",
"description": "Folder path to search within (e.g., \"/Documents\"). Empty string means root."
},
"exactMatch": {
"type": "boolean",
"default": false,
"description": "If true, find files with exact filename match (only searches direct children of path, not recursive). If false (default), performs fuzzy full-text search."
},
"maxResults": {
"type": "number",
"default": 100,
"description": "Maximum number of results"
},
"fileExtensions": {
"type": "array",
"items": {
"type": "string"
},
"description": "Filter by file extensions (e.g., [\"pdf\", \"docx\"])"
},
"fileCategories": {
"type": "array",
"items": {
"type": "string"
},
"description": "Filter by categories (e.g., [\"image\", \"document\"])"
}
},
"required": [
"PCID",
"query"
]
}
```
***
## dropbox\_create\_shared\_link
Create a shared link for a file or folder
**Parameters:**
| Parameter | Type | Required | Default | Description |
| --------------- | ------- | -------- | ------- | ------------------------------------- |
| `path` | string | Yes | — | Path of file or folder to share |
| `shortUrl` | boolean | No | `false` | Create short URL |
| `pendingUpload` | boolean | No | `false` | Allow sharing before upload completes |
```json theme={null}
{
"type": "object",
"properties": {
"PCID": {
"type": "string",
"description": "Pink Connect ID"
},
"path": {
"type": "string",
"description": "Path of file or folder to share"
},
"shortUrl": {
"type": "boolean",
"default": false,
"description": "Create short URL"
},
"pendingUpload": {
"type": "boolean",
"default": false,
"description": "Allow sharing before upload completes"
}
},
"required": [
"PCID",
"path"
]
}
```
***
## dropbox\_get\_account\_info
Get current Dropbox account information
```json theme={null}
{
"type": "object",
"properties": {
"PCID": {
"type": "string",
"description": "Pink Connect ID"
}
},
"required": [
"PCID"
]
}
```
***
## dropbox\_get\_space\_usage
Get Dropbox account space usage information
```json theme={null}
{
"type": "object",
"properties": {
"PCID": {
"type": "string",
"description": "Pink Connect ID"
}
},
"required": [
"PCID"
]
}
```