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-shortcutThe 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.
- Get Contents of URL: paste your check URL. Leave Method set to GET.
- Get Dictionary Value: get
Valueforlatest_versioninContents of URL. - If:
Dictionary Value. Tap it and set its type toText, so the If offersis. Chooseis, then type the version of this copy, for example1.0. - Show Notification, inside If:
Up to date. - Get Dictionary Value, under Otherwise: get
Valueforinstall_urlinContents of URL. - If, under Otherwise after step 5: the
Dictionary Valuefrom step 5has any value. - Show Alert, inside the second If: title
Update available, messageVersionfollowed by theDictionary Valuefrom step 2. Keep Show Cancel Button on, so people can say no. - Open URLs, after Show Alert: the
Dictionary Valuefrom 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.