Dropbox

The files your team already keeps there. Reads, and the writes you grant.

Connects with	OAuth
Reads	9 operations
Writes	7 operations, each granted separately
Irreversible	1 operations, granted separately
Personal data	Whatever the connecting person’s Dropbox holds.
Data stays in	AWS Sydney (ap-southeast-2)

What it reads

• A folder’s files and subfolders, and each item’s name, path, size and modified time.
• Search across file and folder names, and file contents where Dropbox indexes them.
• A file’s saved revisions.
• A file itself, through a short-lived download link.
• The shared links on a file or folder.

What it does not read

Nothing is excluded by scope. The connection sees what the person who approved it sees, so connect as someone whose Dropbox holds only what StoriBot should reach.

What it writes

Each of these is a separate operation you grant or withhold.

• Upload a file from the Stori.
• Create a folder.
• Move or copy a file or folder. Both refuse to overwrite: if the destination exists, the operation fails.
• Restore a file to an earlier revision.
• Create a shared link. With no settings, Dropbox usually makes a public view link.

Irreversible operations

Granted separately, and only where StoriBot may act unattended.

• Delete a file or folder. Dropbox moves it to the trash, and only you can bring it back, from Dropbox, for at least thirty days.

How you connect it

Connect with OAuth. From the Integrations page, choose Connect on Dropbox, tick the operations StoriBot may use, and approve at Dropbox signed in as yourself.

What StoriBot will ask for

Dropbox’s consent screen lists the scopes the ticked operations need: files.metadata.read and files.content.read for reads, files.content.write for the writes, and sharing.read or sharing.write for shared links. No scope is requested for an operation you did not tick.

Every operation

These are the names the Integrations page shows beside each tick box, in the order it lists them. Generated from the connector registry; do not edit by hand.

All 17 operations

Operation	Kind	What it does
list_folder	Read	List a folder’s files and subfolders, 200 at a time.
list_folder_continue	Read	Fetch the next page of a list_folder call.
get_metadata	Read	Describe one file or folder: name, path, size, rev, modified time.
search	Read	Search file and folder names, and file contents where Dropbox indexes them, up to 100 matches.
search_continue	Read	Fetch the next page of a search call.
list_revisions	Read	List a file’s saved revisions, newest first, each with a rev usable by restore.
get_temporary_link	Read	Get a direct download link for a file.
upload_file	Write	Copy a file from your workspace into Dropbox.
upload_file_status	Read	Check an upload_file job by its async_job_id.
get_temporary_upload_link	Write	Get a one-time link to upload one file under 150 MiB straight from your box.
list_shared_links	Read	List the shared links on a file or folder, or every shared link when path is omitted.
create_folder	Write	Create a folder.
move	Write	Move a file or folder to a new path.
copy	Write	Copy a file or folder to a new path.
delete	Irreversible	Move a file or folder to the trash.
restore	Write	Restore a file to an earlier revision.
create_shared_link	Write	Create a shared link for a file or folder.