Dropbox
Dropbox is a file hosting service that offers cloud storage, file synchronization, personal cloud, and client software.
Categories: file-storage
Type: dropbox/v1
Connections
Version: 1
OAuth2 Authorization Code
Properties
Name | Label | Type | Control Type | Description | Required |
---|---|---|---|---|---|
clientId | Client Id | STRING | TEXT | true | |
clientSecret | Client Secret | STRING | TEXT | true |
Actions
Copy
Name: 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 | Label | Type | Control Type | Description | Required |
---|---|---|---|---|---|
filename | Filename | STRING | TEXT | Name of the file with the extension. Don’t fill in if you want a folder. | false |
from_path | Source Path | STRING | TEXT | The path which the file or folder should be copyed from. Root is /. | true |
to_path | Destination Path | STRING | TEXT | The path which the file or folder should be copyed to. Root is /. | true |
Output
Type: OBJECT
Properties
Name | Type | Control Type |
---|---|---|
metadata | {STRING(.tag), STRING(name), STRING(path_lower), STRING(path_display), STRING(id)} | OBJECT_BUILDER |
Create New Folder
Name: createFolder
Create a folder at a given path.
Properties
Name | Label | Type | Control Type | Description | Required |
---|---|---|---|---|---|
path | Folder Path/Name | STRING | TEXT | The path of the new folder. Root is /. | true |
Output
Type: OBJECT
Properties
Name | Type | Control Type |
---|---|---|
metadata | {STRING(name), STRING(path_lower), STRING(path_display), STRING(id)} | OBJECT_BUILDER |
Create New Paper File
Name: createTextFile
Create a new .paper file on which you can write at a given path
Properties
Name | Label | Type | Control Type | Description | Required |
---|---|---|---|---|---|
path | Path | STRING | TEXT | The path of the new paper file. Root is /. | true |
filename | Filename | STRING | TEXT | Name of the paper file | true |
text | Text | STRING | TEXT_AREA | The text to write into the file. | true |
autorename | 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. | false |
mute | 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. | false |
strict_conflict | 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. | false |
Output
Type: OBJECT
Properties
Name | Type | Control Type |
---|---|---|
url | STRING | TEXT |
resultPath | STRING | TEXT |
fileId | STRING | TEXT |
paperRevision | INTEGER | INTEGER |
Delete
Name: 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 | Label | Type | Control Type | Description | Required |
---|---|---|---|---|---|
path | Path | STRING | TEXT | Path of the file or folder. Root is /. | true |
filename | Filename | STRING | TEXT | Name of the file. Leave empty if you want to delete a folder. | false |
Output
Type: OBJECT
Properties
Name | Type | Control Type |
---|---|---|
metadata | {STRING(.tag), STRING(name), STRING(path_lower), STRING(path_display), STRING(id)} | OBJECT_BUILDER |
Get File Link
Name: getFileLink
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 | Label | Type | Control Type | Description | Required |
---|---|---|---|---|---|
path | Namepath to the File | STRING | TEXT | The path to the file you want a temporary link to. Root is /. | true |
filename | Filename | STRING | TEXT | Name of the file with the extension. Needs to have a streamable extension (.mp4, .mov, .webm, ect) | true |
Output
Type: OBJECT
Properties
Name | Type | Control Type |
---|---|---|
metadata | {STRING(name), STRING(path_lower), STRING(path_display), STRING(id)} | OBJECT_BUILDER |
link | STRING | TEXT |
List Folder
Name: listFolder
List the contents of a folder.
Properties
Name | Label | Type | Control Type | Description | Required |
---|---|---|---|---|---|
path | Path | STRING | TEXT | Path of the filename. Inputting nothing searches root. | false |
Output
Type: OBJECT
Properties
Name | Type | Control Type |
---|---|---|
entries | [{{STRING(.tag), STRING(name), STRING(path_lower), STRING(path_Display), STRING(id)}(f)}] | ARRAY_BUILDER |
Move
Name: 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 | Label | Type | Control Type | Description | Required |
---|---|---|---|---|---|
filename | Filename | STRING | TEXT | Name of the file with the extension. Don’t fill in if you want a folder. | false |
from_path | Source Path | STRING | TEXT | Path in the user’s Dropbox to be moved. Root is /. | true |
to_path | Destination Path | STRING | TEXT | Path in the user’s Dropbox that is the destination. Root is /. | true |
Output
Type: OBJECT
Properties
Name | Type | Control Type |
---|---|---|
metadata | {STRING(.tag), STRING(name), STRING(path_lower), STRING(path_display), STRING(id)} | OBJECT_BUILDER |
Search
Name: 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 | Label | Type | Control Type | Description | Required |
---|---|---|---|---|---|
query | Search String | STRING | TEXT | The string to search for. May match across multiple fields based on the request arguments. | true |
Output
Type: OBJECT
Properties
Name | Type | Control Type |
---|---|---|
matches | [{{STRING(.tag)}(match_type), {STRING(.tag), STRING(id), STRING(name), STRING(path_display), STRING(path_lower)}(metadata)}] | ARRAY_BUILDER |
Upload File
Name: uploadFile
Create a new file up to a size of 150MB with the contents provided in the request.
Properties
Name | Label | Type | Control Type | Description | Required |
---|---|---|---|---|---|
fileEntry | File | FILE_ENTRY | FILE_ENTRY | The object property which contains a reference to the file to be written. | true |
path | Destination Path | STRING | TEXT | The path to which the file should be written. | true |
filename | Filename | STRING | TEXT | Name of the file. Needs to have the appropriate extension. | true |
autorename | 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. | false |
mute | 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. | false |
strict_conflict | 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. | false |
Output
Type: OBJECT
Properties
Name | Type | Control Type |
---|---|---|
id | STRING | TEXT |
clientModified | DATE | DATE |
serverModified | DATE | DATE |
rev | STRING | TEXT |
size | INTEGER | INTEGER |
symlinkInfo | {STRING(target)} | OBJECT_BUILDER |
sharingInfo | {STRING(parentSharedFolderId), STRING(modifiedBy)} | OBJECT_BUILDER |
isDownloadable | BOOLEAN | SELECT |
exportInfo | {STRING(exportAs), [STRING](exportOptions)} | OBJECT_BUILDER |
propertyGroups | [{STRING(templateId), [{STRING(name), STRING(value)}](fields)}] | ARRAY_BUILDER |
hasExplicitSharedMembers | BOOLEAN | SELECT |
contentHash | STRING | TEXT |
fileLockInfo | {BOOLEAN(isLockholder), STRING(lockholderName), STRING(lockholderAccountId), DATE(created)} | OBJECT_BUILDER |