About the migration API

Welcome to the documentation page for the migration API. 👋
You can use these APIs to migrate your on-premises instance of Jira or Confluence to the cloud. 🚀

If you're looking for resources on migrating your Atlassian product without using these APIs, visit the Migrate your Atlassian server to Cloud page. Among other information, it describes in-depth how to use the Jira Cloud Migration Assistant and the Confluence Cloud Migration Assistant.

Overview

Migration API offers a set of APIs to create a migration definition, run pre-migration checks or a migration, view statuses and track progress for both pre-migration checks and migrations.

On a high level, running a migration using these APIs consist of the following steps:

Define the migration by calling the /jobs endpoint, which creates a migration job in the cloud, returning a jobId.
Attach the cloud_site_url of the cloud site you are migrating to by calling the /attach endpoint hosted on your server.
Run pre-migration checks or a migration by using the jobId returned in step 1 to call the /jobs/{jobId}/tasks endpoint. This will create a task in the cloud, returning a taskId to be executed by the Cloud Migration Assistant (CMA).
View the status and progress of your pre-migration checks or migration by using the taskId obtained in step 3 to call the /jobs/{jobId}/tasks/{taskId}/status endpoint.

Resources 📚

Guide to migrate Jira or Confluence to cloud using public APIs
Migration API Reference
Migration support home: Migrate your Atlassian Server to Cloud
Product link migration API: Reference. You may find this API useful to fix product links inside your Atlassian products after you've completed your migration.