list_revisions
POST https://api.dropboxapi.com/2/files/list_revisions
scope: files.metadata.read
Returns revisions for files based on a file path or a file id. The file path or file id is identified from the latest file entry at the given file path or id. This end point allows your app to query either by file path or file id by setting the mode parameter appropriately.
In the ListRevisionsMode.path
(default) mode, all revisions at the same file path as the latest file entry are returned. If revisions with the same file id are desired, then mode must be set to ListRevisionsMode.id
. The ListRevisionsMode.id
mode is useful to retrieve revisions for a given file across moves or renames.
Request Body
{"path"=>"/root/word.docx", "mode"=>"path", "limit"=>10}
HEADERS
Key | Datatype | Required | Description |
---|---|---|---|
Content-Type | string | ||
Dropbox-API-Path-Root | string | ||
Dropbox-API-Select-User | string | ||
Dropbox-API-Select-Admin | string |
RESPONSES
status: OK
{"is_deleted":false,"entries":[{"name":"Prime_Numbers.txt","id":"id:a4ayc_80_OEAAAAAAAAAXw","client_modified":"2015-05-12T15:50:38Z","server_modified":"2015-05-12T15:50:38Z","rev":"a1c10ce0dd78","size":7212,"path_lower":"/homework/math/prime_numbers.txt","path_display":"/Homework/math/Prime_Numbers.txt","sharing_info":{"read_only":true,"parent_shared_folder_id":"84528192421","modified_by":"dbid:AAH4f99T0taONIb-OurWxbNQ6ywGRopQngc"},"is_downloadable":true,"property_groups":[{"template_id":"ptid:1a5n2i6d3OYEAAAAAAAAAYa","fields":[{"name":"Security Policy","value":"Confidential"}]}],"has_explicit_shared_members":false,"content_hash":"e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855","file_lock_info":{"is_lockholder":true,"lockholder_name":"Imaginary User","created":"2015-05-12T15:50:38Z"}}]}