Migrate from Media Services v2 to v3 introduction

migration guide logo

The Media Services migration guide helps you migrate from Media Services V2 APIs to V3 APIs based on a migration that takes advantage of the new features and functions that are now available. You should use your best judgment and determine what best fits your scenario.

How to use this guide

Throughout the guide, you will see the following graphic.

migration steps

The step you are on will be indicated by a color change in the number of the step, like so:

migration steps 2

At the end of each page, you will see links to the rest of the migration documents you can read underneath the Next steps heading.


The guidance provided here is general. It includes content to improve your awareness of what is now available in V3 as well as what has changed in the Media Services workflows.

For more detailed guidance, including screenshots and conceptual graphics, there are links to concepts, tutorials, quickstarts, samples and API references in each scenario-based topic. We have also listed samples that help you compare the V2 API to the V3 API.

Migration guidance overview

There are four general steps to follow during your migration:

Step 1 Benefits

Understand the benefits of migrating to Media Services API V3.

Step 2 Differences

Understand the differences between Media Services V2 API and the V3 API.

Step 3 SDK setup

Understand the SDK differences and set up to migrate to the V3 REST API or client SDK.

Step 4 Scenario-based guidance

Your application of Media Services V2 may be unique. Therefore, we have provided scenario-based guidance based on how you may have used media services in the past and the steps for each feature of the service such as: