Skip to main content

Update check

Add these actions to your shortcut and it checks Shortcutly each time it runs. Once a newer version is approved, it shows Update available and opens the new iCloud link. Otherwise it shows Up to date.

Your check URL

The check reads your shortcut from the public API, which needs no key. The URL ends with the slug from your shortcut's page address.

Paste the address of your shortcut's page. The URL below updates as you type.

https://www.shortcutly.com/api/v1/shortcuts/your-shortcut

The actions

In the Shortcuts app, add these at the end of your shortcut, so a failed check never stops its main job. Each If brings its own Otherwise and End If.

  1. Get Contents of URL: paste your check URL. Leave Method set to GET.
  2. Get Dictionary Value: get Value for latest_version in Contents of URL.
  3. If: Dictionary Value. Tap it and set its type to Text, so the If offers is. Choose is, then type the version of this copy, for example 1.0.
  4. Show Notification, inside If: Up to date.
  5. Get Dictionary Value, under Otherwise: get Value for install_url in Contents of URL.
  6. If, under Otherwise after step 5: the Dictionary Value from step 5 has any value.
  7. Show Alert, inside the second If: title Update available, message Version followed by the Dictionary Value from step 2. Keep Show Cancel Button on, so people can say no.
  8. Open URLs, after Show Alert: the Dictionary Value from step 5.

To show what changed, add Get Dictionary Value for releases, Get Item from List with First Item, and Get Dictionary Value for notes before Show Alert, and put that value in its message. Releases are listed newest first, so the first one is the version in latest_version.

How versions are compared

Shortcutly versions are free text that starts with a digit, such as 1.0, 2.3.1 or 1.0-beta2, so the check compares them as text, not as numbers. Any difference from the newest approved version counts as an update.

Before you share a new version, change the version in step 3 to match exactly what you will submit, then copy the iCloud link and submit it.

What the check sees

  • Approved versions only. While a version is in review, the check reports the previous one, so your own copy of the new version offers the older one until approval.
  • Answers are cached for up to five minutes, so a newly approved version can take about six minutes to reach every copy.
  • The slug in the URL. If you change your shortcut's slug, the old URL stops answering, and copies that use it never see an update.
  • The public API limit of 60 requests per 60 seconds from one network. Past it, or when the shortcut is not public, the check does nothing.

Every field in the response is described in the API and MCP docs.