In this guide

List Shared Links

Existing shared links for a file, folder or your account.

Action referenceRead

What this action does #

First, connect Dropbox in Services. Then open Actions → + → Dropbox and choose List Shared Links.

More about this action

With no path, lists links in the user's home folder. With a path, also returns parent-folder links unless Direct only is enabled.

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 or folder path

OptionalText

Supply a text value for this input.

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

Example value (replace with your own):
/Homework/report.pdf

Direct only

OptionalOn or off

Supply a on or off value for this input.

Default: false

Cursor

OptionalText

Supply a text value for this input.

Example value (replace with your own):
AzQ0R1...

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 fieldTypeMeaning
linksarrayA list of values.
links[].urlstringText value.
links[].namestringText value.
links[].path_lowerstringText value.
links[].idstringText value.
links[].expiresstringText value.
cursorstringText value.
has_morebooleanTrue or false.

Run it from Shortcuts #

  1. Give the action a recognizable name and tap Save.
  2. In Apple Shortcuts, add Shortcutify’s Execute Action and select the saved action.
  3. 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.

This action supports multiple pages of results. Open its Fetch setting to retrieve more pages when one page is not enough. Each page adds a service request.

Advanced reference #

Request, permissions, and identifiers

Request: POST https://api.dropboxapi.com/2/sharing/list_shared_links

Action identifier: dropbox.links.list.v1

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

InputRequest keyLocation
File or folder pathpathbody
Direct onlydirect_onlybody
Cursorcursorbody

Dropbox API reference