• Notification API
  • Status API
  • Mapping API
  • App data retrieval API
  • Transfer retrieval API
  • Feedback channel API
  • Error retrieval API
Platform
App migration platform / Reference / REST API

Status API

Postman Collection
OpenAPI

Provides endpoints to update the status of the transfer. To learn more, see App migration transfers.

POST

Send migration progress

Updates migration status for a given transfer ID.

When you implement the listener interface in your server app, your cloud app must use this operation to:

  • Report progress on your app migration so that admin users can monitor it in the Cloud Migration Assistant.

  • Settle the transfer at the end of your migration by updating its status to SUCCESS, INCOMPLETE, or FAILED so that admin users know it's finished.

Once a transfer is settled, subsequent requests for that transfer ID return an HTTP 403 error.

Request

Path parameters

transferId

string

Required

Request bodyapplication/json

progressEndpointDto

status

string

Required
percent

integer

message

string

Responses

OK

application/json

ProgressEndpointDto
POST/progress/{transferId}
1 2 3 4 5 6 7 8 9 curl --request POST \ --url 'https://your-site.atlassian.net/rest/atlassian-connect/1/migration/progress/{transferId}' \ --header 'Accept: application/json' \ --header 'Content-Type: application/json' \ --data '{ "status": "IN_PROGRESS", "percent": 90, "message": "App data migration is in the last stage. For more info, refer to {{link:http://documentation.example.com}}." }'
200Response
1 2 3 4 5 { "status": "IN_PROGRESS", "percent": 90, "message": "App data migration is in the last stage. For more info, refer to {{link:http://documentation.example.com}}." }