In this guide

List File Revisions

Previous versions of a file, without restoring or changing it.

Action referenceRead

What this action does #

First, connect Dropbox in Services. Then open Actions → + → Dropbox and choose List File Revisions.

More about this action

Returns one page. To read older revisions, supply the last entry's rev as Before revision. Revisions follow the file path, rather than moves and renames.

Inputs to fill in #

Open an input to choose its value. Keep a fixed value with Text, receive it from Shortcuts, ask when the action runs, or use an Earlier Step. Read how input sources work.

File

RequiredText

Choose a file or type its absolute Dropbox path.

This input offers a picker for file from your connected account. You can also supply its value directly.

Example value (replace with your own):

/Homework/report.pdf

Revision count

OptionalWhole number

Supply a whole number value for this input.

Default: 10

Example value (replace with your own):

Before revision

OptionalText

The last revision from a previous page.

Example value (replace with your own):

a1c10ce0dd78

What comes back #

In the action editor, open Output → Returned Value to choose fields for your shortcut. These are the response fields described by the app; a service may omit an optional field or return an empty list. JSON File contains the full response.

Returned field	Type	Meaning
`entries`	array	A list of values.
`entries[].name`	string	Text value.
`entries[].id`	string	Text value.
`entries[].path_display`	string	Text value.
`entries[].path_lower`	string	Text value.
`entries[].size`	integer	File size in bytes; absent for folders.
`entries[].rev`	string	Text value.
`entries[].server_modified`	string	Text value.
`entries[].client_modified`	string	Text value.
`entries[].is_downloadable`	boolean	True or false.
`entries[].content_hash`	string	Text value.
`has_more`	boolean	True or false.
`is_deleted`	boolean	True or false.

Run it from Shortcuts #

Give the action a recognizable name and tap Save.
In Apple Shortcuts, add Shortcutify’s Execute Action and select the saved action.
Supply any Param or File slots you bound in the inputs, then run the shortcut.

If the result is unexpected, open Logs in Shortcutify, select the run, and inspect this step’s inputs and response.

Advanced reference #

Request, permissions, and identifiers

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

Action identifier: dropbox.revisions.list.v1

Permissions declared for this action: files.metadata.read. The account’s own access rules also apply.

Input	Request key	Location
File	`path`	body
Revision count	`limit`	body
Before revision	`before_rev`	body

Dropbox API reference