Procedures

Automation procedures in the Dropbox BDK Book.

to create a folder at a path

Creates a folder at the specified path in Dropbox.

Input Concepts

Concept
Description
Type
Required
Default Value

path

The absolute path for the new folder (e.g., "/New Folder Name").

text

Yes

autorename

If true, Dropbox will automatically rename the folder if a conflict occurs. Defaults to False.

boolean

No

False

Output Concepts

Concept
Description
Type

The FolderMetadata of the newly created folder.

folder metadata

to delete an item and get the item reference

Deletes a file or folder in Dropbox using its metadata and returns the metadata of the deleted item.

Input Concepts

Concept
Description
Type
Required
Default Value

item

The FileMetadata or FolderMetadata object representing the item to delete.

file metadata or folder metadata

Yes

Output Concepts

Concept
Description
Type

item reference

Metadata (FileMetadata, FolderMetadata, or DeletedMetadata) of the deleted item.

deleted metadata or file metadata or folder metadata

to download a file

Downloads a file from Dropbox using its metadata.

Input Concepts

Concept
Description
Type
Required
Default Value

The FileMetadata object representing the file to download.

file metadata

Yes

Output Concepts

Concept
Description
Type

answer

An IO[bytes] object containing the file content.

file

to upload a file and get the file reference

Uploads a file to a specific path in Dropbox and returns its metadata.

Max file size 150MB. For larger files, use upload sessions.

Input Concepts

Concept
Description
Type
Required
Default Value

file

The file content as a byte stream (IO).

file

Yes

file name

The name the file should have in Dropbox (e.g., "Matrices.txt").

text

Yes

dropbox path

The destination folder path in Dropbox where the file will be uploaded (e.g., "/Homework/math" or "/Homework/math/").

text

Yes

mode

Selects what to do if a file already exists. Can be "add", "overwrite", or "update".

text

No

add

autorename

If there's a conflict, autorename the file.

boolean

No

True

mute

Whether to mute notifications for this change.

boolean

No

False

client modified timestamp

The client's last modification timestamp (ISO 8601 UTC).

text

No

strict conflict

If true, behaves like 'overwrite' but property groups are not updated.

boolean

No

False

Output Concepts

Concept
Description
Type

A FileMetadata object representing the uploaded file.

file metadata

Last updated

Was this helpful?