Last updated Aug 17, 2021

Rate this page:

Changelog

This page includes release notes and updates about the App migration platform for individuals who develop migration paths to move app data from server/data center to cloud.

Use this page to keep track of new or updated features, deprecations, and bug fixes.

Read our docs on getting support through the right channel.

17 August 2021

Deprecation Notice OSGI and tracker library version changes for server apps

From 17 February 2022, the App migration platform will not be compatible with server apps using:

  • atlassian-app-cloud-migration-osgi library older than version 1.0.0, or

  • atlassian-app-cloud-migration-tracker library older than version 1.26.1

Read the deprecation of old versions of OSGI and tracker libraries for server apps for more information.

30 July 2021

Added Updated dev mode documentation for Cloud Migration Assistants

We have updated the following page about using dev mode in the developer documentation:

27 July 2021

Added Updating documentation

Adjusted sample response in the Request mappings without defining page size of mappings list section.

21 July 2021

Added Migration path readiness checklist for Marketplace Partners

We have added a migration path readiness checklist to the documentation. We strongly recommend that Marketplace Partners use the checklist of steps on this page to assess the readiness of their migration path.

13 July 2021

Added Updating documentation

Apps must use the ‘Progress reporting’ feature as part of building their migration path. This allows apps to display the progress of the migration to customers in the Cloud Migration Assistant user interface. We have updated information in the developer documentation about using the Progress reporting feature.

1 June 2021

Deprecation Notice Deprecation notice for webhookEventType field

From 01 December 2021, the App migration platform will not expose the webhookEventType attribute. As a replacement, you will need to use the eventType attribute.

Read the deprecation notice of webhookEventType values for more information.

Deprecation Notice Progress Endpoint Data Transfer Object (DTO) changes

From 01 December 2021, the App migration platform will not support using the progressStatus and statusMessage attributes to accept migration progress reports. As a replacement, you will need the status and message attributes.

Read the deprecation notice of progress endpoint DTO changes for more information.

17 May 2021

Added Updating documentation

We have added information about the new identity mapping identity:group:

11 May 2021

Added Adding documentation

We have added the following new page about rate limits in the developer documentation:

3 March 2021

Added Adding documentation

We have added the following new pages about testability in the developer documentation:

17 February 2021

Deprecation Notice Replacement of the existing migration model

From 17 April 2021, the App migration platform will no longer support the existing migration model of retrieving details of migrations with containers (space and project keys).

In order to retrieve migration details, you will need to use the new migration model EnrichedMigrationDetailsDtoV1 without the containers and creator fields.

Read the deprecation notice of this feature for more information.

Announcement App migration platform beta version available

The App migration platform beta version is now available.

Added Adding a Transfer retrieval API

Marketplace Partners can now use endpoints of the newly added Transfer retrieval API to do the following:

  • Fetch details about the last 100 active app migration transfers with migration details in new migration model

  • Get a list of all containers (like Confluence spaces, Jira projects) associated with the migration for a given containerType in a paginated form (limited to 250 containers)

21 October 2020

Added Adding a Marketplace migration API

As part of app migration, Marketplace Partners (vendors) can now use the new Marketplace migration API to serve updates to the product UIs for app assessment purposes.

20 October 2020

Deprecation Notice Deleting webhook endpoints

From 18 November 2020, the App migration platform will no longer support deleting webhook endpoints using POST /migration/webhook/delete.

Read the deprecation notice of this feature for more information.