upload_session/start
POST https://content.dropboxapi.com/2/files/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
Key | Datatype | Required | Description |
---|---|---|---|
Dropbox-API-Arg | string | ||
Dropbox-API-Path-Root | string | ||
Dropbox-API-Select-User | string | ||
Dropbox-API-Select-Admin | string |
RESPONSES
status: OK
{"session_id":"1234faaf0678bcde"}