Name |
Type |
Required |
Description |
path |
string |
Yes |
The full path to the file you want to write to. This parameter should not point to a folder. |
upload_id |
String |
yes |
Used to identify the chunked upload session you'd like to commit. |
overwrite |
boolean |
No |
This value, either true (default) or false, determines whether an existing file will be overwritten by this upload. If true, any existing file will be overwritten. If false, the other parameters determine whether a conflict occurs and how that conflict is resolved. |
autorename |
boolean |
No |
This value, either true (default) or false, determines what happens when there is a conflict. If true, the file being uploaded will be automatically renamed to avoid the conflict. (For example, test.txt might be automatically renamed to test (1).txt.) The new name can be obtained from the returned metadata. If false, the call will fail with a 409 (Conflict) response code. |
locale |
string |
No |
The metadata returned on successful upload will have its size field translated based on the given locale. |
parent_rev |
Boolean |
No |
If present, this parameter specifies the revision of the file you're editing. If parent_rev matches the latest version of the file on the user's Dropbox, that file will be replaced. Otherwise, a conflict will occur. If you specify a parent_rev and that revision doesn't exist, the file won't save (error 400). |