upload_session/start

POST https://content.dropboxapi.com/2/files/upload_session/start

upload_session/start

scope: files.content.write

Upload sessions allow you to upload a single file in one or more requests, for example where the size of the file is greater than 150 MB. This call starts a new upload session with the given data. You can then use upload_session/append:2 to add more data and upload_session/finish to save all the data to a file in Dropbox. A single request should not upload more than 150 MB. The maximum size of a file one can upload to an upload session is 350 GB. An upload session can be used for a maximum of 48 hours. Attempting to use an UploadSessionStartResult.session_id with upload_session/append:2 or upload_session/finish more than 48 hours after its creation will return a UploadSessionLookupError.not_found. Calls to this endpoint will count as data transport calls for any Dropbox Business teams with a limit on the number of data transport calls allowed per month. For more information, see the Data transport limit page.

HEADERS

KeyDatatypeRequiredDescription
Dropbox-API-Argstring
Dropbox-API-Path-Rootstring
Dropbox-API-Select-Userstring
Dropbox-API-Select-Adminstring

RESPONSES

status: OK

{"session_id":"1234faaf0678bcde"}