We are moving the Shortcut API out of Beta to v3!
By migrating to the Shortcut API v3, organizations can now take advantage of @-mention parsing in comments and additional enhancements coming soon, such as:
We are encouraging teams using v1, v2, and Beta to migrate their custom workflows to v3 as soon as possible. Older versions will deprecate on March 2nd, 2020, and any systems that use these older versions will no longer work.
Streamlining older versions allows us to modernize and implement updates to the API more quickly going forward. The latest update ensures that the API is continually maintained with the latest technologies that reflect the changing needs of Shortcut users.
We recommend these migration steps to Shortcut API v3:
api.clubhouse.io
to quickly find code that is using the API. If you have source-controlled your implementations with GitHub, you can use their search. If you are using Linux or a Linux-like system, consider using the grep command.v1
, v2
, or beta
to v3
in the URL string. In certain circumstances, you may need to rework your logic or even use a different endpoint. https://api.clubhouse.io/api/beta/search/stories
https://api.clubhouse.io/api/v3/search/stories
https://api.clubhouse.io/api/v2/search/stories
https://api.clubhouse.io/api/v3/search/stories
Want some ideas on how to use the Shortcut API? Check out this webinar to learn from the Shortcut team and learn how Francesco Crippa, VP of Engineering at Rollbar, is using the Shortcut API to build a Cycle Time Report.
If you have any questions about the migration please leave a comment below or reach out to our support team at support@clubhouse.io