Migrate from v1 to v2

Now that the Miro Developer Platform 2.0 has launched to General Availability, it is the recommended platform for all new application development. Consequently, we plan to sunset the v1 platform on July 30, 2024. If your app currently uses v1, it’s time to plan your migration to v2.

Note: This does not apply to Miro's OAuth2.0 endpoint (/v1/oauth). It is not part of the required migration and it will continue to support all versions of the Miro REST API.

To help developers migrate their existing applications from v1, we have created the following resources:

  • Web SDK
    • Comparison Guide – a walkthrough of the major changes of the Web SDK and usage examples
    • Reference Guide – a full mapping of each Web SDK v1 endpoint and its equivalent in v2
    • Comparison Guide – a walkthrough of the major changes of the REST API, including an overview of the new object structures
    • Reference Guide – a full mapping of each REST API v1 endpoint and its equivalent in v2, including the request type, the endpoint URL, the headers required, and example payloads

Feature Parity

For the initial launch of the Developer Platform v2, we have focused on delivering the features needed to support the development of high quality integrations. As a result, many of the features that were available in v1 are now available in v2, including a number of new features that are unique to v2. A full list of v1 features and their v2 counterparts can be found in the reference guides.

In some cases, we may have chosen not to bring a v1 feature to v2 if that feature had low usage or conflicted with our future plans. Each instance should be explained in the reference guide, but if you have any questions or concerns, please post them in our community forum.


Understand which version your apps are on

Developers can see which version of the Developer Platform an app uses from the Team Profile:

  1. Your apps section of Team Profile
    1. Team Settings > Profile Settings > Your Apps