Dropbox
Reference
Dropbox is a file hosting service that offers cloud storage, file synchronization, personal cloud, and client software.
Categories: [file-storage]
Version: 1
Connections
Version: 1
OAuth2 Authorization Code
Properties
| Name | Type | Control Type | Description |
|---|---|---|---|
| Client Id | STRING | TEXT | |
| Client Secret | STRING | TEXT |
Actions
Copy
Copy a file or folder to a different location in the user’s Dropbox. If the source path is a folder all its contents will be copied.
Properties
| Name | Type | Control Type | Description |
|---|---|---|---|
| Filename | STRING | TEXT | Name of the file with the extension. Don’t fill in if you want a folder. |
| Source path | STRING | TEXT | The path which the file or folder should be copyed from. Root is /. |
| Destination path | STRING | TEXT | The path which the file or folder should be copyed to. Root is /. |
Output
Type: OBJECT
Properties
| Type | Control Type |
|---|---|
| {STRING(.tag), STRING(name), STRING(path_lower), STRING(path_display), STRING(id)} | OBJECT_BUILDER |
Create new folder
Create a folder at a given path.
Properties
| Name | Type | Control Type | Description |
|---|---|---|---|
| Folder path/name | STRING | TEXT | The path of the new folder. Root is /. |
Output
Type: OBJECT
Properties
| Type | Control Type |
|---|---|
| {STRING(name), STRING(path_lower), STRING(path_display), STRING(id)} | OBJECT_BUILDER |
Create a new paper file
Create a new .paper file on which you can write at a given path
Properties
| Name | Type | Control Type | Description |
|---|---|---|---|
| Path | STRING | TEXT | The path of the new paper file. Root is /. |
| Filename | STRING | TEXT | Name of the paper file |
| Text | STRING | TEXT_AREA | The text to write into the file. |
| Auto Rename | BOOLEAN | SELECT | If there’s a conflict, as determined by mode, have the Dropbox server try to autorename the file to avoid conflict. |
| Mute | BOOLEAN | SELECT | Normally, users are made aware of any file modifications in their Dropbox account via notifications in the client software. If true, this tells the clients that this modification shouldn’t result in a user notification. |
| Strict conflict | BOOLEAN | SELECT | Be more strict about how each WriteMode detects conflict. For example, always return a conflict error when mode = WriteMode.update and the given “rev” doesn’t match the existing file’s “rev”, even if the existing file has been deleted. |
Output
Type: OBJECT
Properties
| Type | Control Type |
|---|---|
| STRING | TEXT |
| STRING | TEXT |
| STRING | TEXT |
| INTEGER | INTEGER |
Delete
Delete the file or folder at a given path. If the path is a folder, all its contents will be deleted too.
Properties
| Name | Type | Control Type | Description |
|---|---|---|---|
| Path | STRING | TEXT | Path of the file or folder. Root is /. |
| Filename | STRING | TEXT | Name of the file. Leave empty if you want to delete a folder. |
Output
Type: OBJECT
Properties
| Type | Control Type |
|---|---|
| {STRING(.tag), STRING(name), STRING(path_lower), STRING(path_display), STRING(id)} | OBJECT_BUILDER |
Get file link
Get a temporary link to stream content of a file. This link will expire in four hours and afterwards you will get 410 Gone. This URL should not be used to display content directly in the browser. The Content-Type of the link is determined automatically by the file’s mime type.
Properties
| Name | Type | Control Type | Description |
|---|---|---|---|
| Path to the file | STRING | TEXT | The path to the file you want a temporary link to. Root is /. |
| Filename | STRING | TEXT | Name of the file with the extension. Needs to have a streamable extension (.mp4, .mov, .webm, ect) |
Output
Type: OBJECT
Properties
| Type | Control Type |
|---|---|
| {STRING(name), STRING(path_lower), STRING(path_display), STRING(id)} | OBJECT_BUILDER |
| STRING | TEXT |
List folder
List the contents of a folder.
Properties
| Name | Type | Control Type | Description |
|---|---|---|---|
| Path | STRING | TEXT | Path of the filename. Inputting nothing searches root. |
Output
Type: OBJECT
Properties
| Type | Control Type |
|---|---|
| [{{STRING(.tag), STRING(name), STRING(path_lower), STRING(path_Display), STRING(id)}(f)}] | ARRAY_BUILDER |
Move
Move a file or folder to a different location in the user’s Dropbox. If the source path is a folder all its contents will be moved. Note that we do not currently support case-only renaming.
Properties
| Name | Type | Control Type | Description |
|---|---|---|---|
| Filename | STRING | TEXT | Name of the file with the extension. Don’t fill in if you want a folder. |
| Source path | STRING | TEXT | Path in the user’s Dropbox to be moved. Root is /. |
| Destination path | STRING | TEXT | Path in the user’s Dropbox that is the destination. Root is /. |
Output
Type: OBJECT
Properties
| Type | Control Type |
|---|---|
| {STRING(.tag), STRING(name), STRING(path_lower), STRING(path_display), STRING(id)} | OBJECT_BUILDER |
Search
Searches for files and folders. Can only be used to retrieve a maximum of 10,000 matches. Recent changes may not immediately be reflected in search results due to a short delay in indexing. Duplicate results may be returned across pages. Some results may not be returned.
Properties
| Name | Type | Control Type | Description |
|---|---|---|---|
| Search string | STRING | TEXT | The string to search for. May match across multiple fields based on the request arguments. |
Output
Type: OBJECT
Properties
| Type | Control Type |
|---|---|
| [{{STRING(.tag)}(match_type), {STRING(.tag), STRING(id), STRING(name), STRING(path_display), STRING(path_lower)}(metadata)}] | ARRAY_BUILDER |
Upload file
Create a new file up to a size of 150MB with the contents provided in the request.
Properties
| Name | Type | Control Type | Description |
|---|---|---|---|
| File | FILE_ENTRY | FILE_ENTRY | The object property which contains a reference to the file to be written. |
| Destination path | STRING | TEXT | The path to which the file should be written. |
| Filename | STRING | TEXT | Name of the file. Needs to have the appropriate extension. |
| Auto Rename | BOOLEAN | SELECT | If there’s a conflict, as determined by mode, have the Dropbox server try to autorename the file to avoid conflict. |
| Mute | BOOLEAN | SELECT | Normally, users are made aware of any file modifications in their Dropbox account via notifications in the client software. If true, this tells the clients that this modification shouldn’t result in a user notification. |
| Strict conflict | BOOLEAN | SELECT | Be more strict about how each WriteMode detects conflict. For example, always return a conflict error when mode = WriteMode.update and the given “rev” doesn’t match the existing file’s “rev”, even if the existing file has been deleted. |
Output
Type: OBJECT
Properties
| Type | Control Type |
|---|---|
| STRING | TEXT |
| DATE | DATE |
| DATE | DATE |
| STRING | TEXT |
| INTEGER | INTEGER |
| {STRING(target)} | OBJECT_BUILDER |
| {STRING(parentSharedFolderId), STRING(modifiedBy)} | OBJECT_BUILDER |
| BOOLEAN | SELECT |
| {STRING(exportAs), [STRING](exportOptions)} | OBJECT_BUILDER |
| [{STRING(templateId), [{STRING(name), STRING(value)}](fields)}] | ARRAY_BUILDER |
| BOOLEAN | SELECT |
| STRING | TEXT |
| {BOOLEAN(isLockholder), STRING(lockholderName), STRING(lockholderAccountId), DATE(created)} | OBJECT_BUILDER |
Additional instructions
