list_revisions

POST https://api.dropboxapi.com/2/files/list_revisions

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

KeyDatatypeRequiredDescription
Content-Typestring
Dropbox-API-Path-Rootstring
Dropbox-API-Select-Userstring
Dropbox-API-Select-Adminstring

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"}}]}