Dropbox integration

In short

List folders, upload and download files, and create share links. Connect it on the Integrations page; your app then calls Dropbox through Sapilon without ever holding a Dropbox credential.

Lets your app list folders, upload and download files and create share links in the connected Dropbox account.

Connecting

On the Integrations page choose Connect on Dropbox, sign in to Dropbox and allow access. Under Advanced you can use your own Dropbox OAuth app instead of Sapilon’s.

Your app can read and write files across the connected Dropbox account.

What your app can do

Only these requests are available; anything else is refused.

POST /2/files/list_folder
POST /2/files/list_folder/continue
POST /2/files/get_metadata
POST /2/sharing/create_shared_link_with_settings
POST /2/files/upload
POST /2/files/download

How the agent uses it

Use integrations.request('dropbox', …). Everything is a POST. Metadata calls go to https://api.dropboxapi.com; /2/files/upload and /2/files/download go to https://content.dropboxapi.com (chosen for you by path).

POST /2/files/list_folder — Example: { method: 'POST', path: '/2/files/list_folder', body: { path: '/Contracts' } } (root is '').
POST /2/files/list_folder/continue — Example: { method: 'POST', path: '/2/files/list_folder/continue', body: { cursor } }.
POST /2/files/get_metadata — Example: { method: 'POST', path: '/2/files/get_metadata', body: { path: '/a.pdf' } }.
POST /2/sharing/create_shared_link_with_settings — Example: { method: 'POST', path: '/2/sharing/create_shared_link_with_settings', body: { path: '/a.pdf' } }.
POST /2/files/upload / download — arguments go in the Dropbox-API-Arg header (JSON string), content as the body, Content-Type: application/octet-stream.