Migration status and progress updates

The API returns the progress/status of your tasks.

However, the progress updates will only be point in time. If you call the status API for a node which is done, you won’t see any progress data. This also means that for nodes that go through multiple phases (e.g. import and export) you’ll only see progress in the current phase.

Because the response could contain a lot of statuses, this API returns paginated responses.

Endpoint

• GET /migrations/public/v1/jobs/{jobId}/tasks/{taskId}/status
• Documentation

Requests and responses

• The statuses for check tasks will have information around the overall status of pre-migration checks. These can be searched with level=check or level=check,{check_type} for specific checks.

• The statuses for migrate tasks will have information about the overall status of the migration and the overall status of individual scopes defined in step 1 (create a migration). You can think of these scopes as subtrees whose root is migrate.

• For Confluence migrations, the following scopes have separate statuses: spaces, usersAndGroups, apps, globalEntities.

• For Jira migrations, the following scopes have separate statuses: projects, usersAndGroups, jsm, ar, apps.

• You can search for these granular statuses by querying the status tree.

• If you're migrating apps, you might see that the overall migrate status is FINISHED, but apps remain IN_PROGRESS. This isn't an error: app migration happens after core migration and is independent from it.

• All statuses are populated in an eventually-consistent manner. You might have to wait before you start seeing the status for everything.

• For a migrate task, always first check the status of the check level and then proceed to check the status of the migrate level. The check level status will show an error if a migration couldn't be scheduled for some reason.

Checkout status examples: : Status examples

Checkout progress details examples: : Progress details examples

Pre-migration check statuses and outcomes