[Data Residency] App Data Residency Migration Test

Hi I have several questions about the process of manual testing:

  1. Should /shedule hook receive information about planned migration immediately after placing the support request ?

  2. Is there a way to view the test result (ex. http status, any information about success or failure) ?

  3. If the duration between startTime and endTime would be exceeded (min. 1h) it means that Jira would rollback the migration ?

  4. Should the time for test request fields startTime and endTime be converted from the profile timezone to UTC+0 ?


1 Like

Hey @KamilBokowski,

I’ve provided some answers in-line below, hopefully this helps. We have more details about our manual testing available here.

We need to manually schedule these, so there can be some delay between the support request being picked up and actioned. With that said, you can provide multiple requests within the support ticket to expedite testing (i.e. schedule a migration from EU to US, then schedule a migration from US to EU 12 hours later).

You should be able to review the status of the app within the Admin portal. If not, please include a note within the request and we can follow-up.

App migrations have up to at 24 hour window to complete the migration. You can however request a shorter window for testing if you like.

As per our testing documentation, this should be UTC+0.

1 Like

Hey @SeanBourke ,
Thanks you for the answers, it clarifies the issue more. I would like to follow up few of the topics:

We are trying to adopt data residency into our app, therefore we would like to test the behavior of the residency mechanizm in different scenarios and establish solid contract. Is there more effective way to do so, instead of waiting 12h for mechanizm to be triggered manually ? The debugging in this case becomes barely possible.

We have created several support tickets at the beginning of the week and all of them have status new, thus do not really know wether the migration occurred or not, the Admin Portal shows that the app status is eligible.

Certainly, nevertheless in the test support ticket I was not able to set custom startTime and endTime for PM time, it switches to AM instead. I was wondering wether it is some validation issue or a bug ?

1 Like

Hi @KamilBokowski ,

I have found your tickets that were indeed marked as spam since some unexpected data was entered in the fields (e.g. there was not Atlassian Cloud premium site URL, etc.).

I have now assigned them to myself. I will handle the 1st one and close the rest as duplicate. Please check the ticket in a bit time and get back to me in there.

Also, for the future, even if not explicitly mentioned in the documentation, requests should be made at least 7 days before the requested date (those ticket SLA is 1 week and when the queue is full it takes that long to get them worked on).


Hi @Dario_B ,

Thank you for handling the case. My bad, i’ve assumed that the process is automated, thus that many tickets were created.

Please correct me if i am wrong, but as i understand the concept of appKey and Premium Cloud URL, those are the key and baseUrl fields from Connect app descriptor file of the production app deployed to the marketplace ?

If those are true, is there a way to test the residency mechanizm locally ? Any suggestion or clarification would be very welcome.


Hello @KamilBokowski ,

The app key is indeed the “key” defined in the connect app descriptor, while the premium site url, as written in the documentation page (Data Residency - Testing Connect data residency migrations):

  • Premium Cloud URL refers to the host name of the site you’are trying to trigger a manual migration test for.

For more information about premium plans please see:


Hi @Dario_B

Thank you for providing details about Cloud Premium plans i will review testing possibilities and get back to the topic if any question arise.


1 Like

Why do we need a Premium Instance to test the DaRe migrations web hooks? Couldn’t dev instances (Sign up - Try Atlassian Cloud | Atlassian) be used?

If Premium instances are really needed, how could we get one for testing purposes?



Hely @ErkkiLepre, DaRe app migration feature is currently only available for premium cloud instances and unfortunately, we don’t have the ability to test it for dev instances. But you can always raise a manual migration test request using the process defined here. Hopefully that helps.

Thanks @ragrawal . That is the indeed the process I’m trying to use, but that process also seems to require a Premium instance. At least according to document you linked.

As a matter of, I created four test schedule requests a week ago, but no reaction yet. How long should I reserve for the requests?

Hey @ErkkiLepre , sorry I missed the part that testing manually also requires a premium subscription. In the same developer support portal you can see a way to request a premium account if you have a paid app on marketplace. Hopefully that helps!

For any other app vendors struggling with testing the DaRe migration webhooks and the response time to the test migration scheduling support requests…

Creating support request to Atlassian is not the only way to test DaRe web hooks. You can just trigger the migration in the Admin UI (Security → Data residency). Unfortunately you must schedule it at least 72h to the future, making the feedback loop quite long, but it’s still a lot better than the 1+ week response time to the support tickets.

Also - no premium instance needed when triggering the migration yourself.

1 Like

Since the only thing I wanted was to test the implementation of the endpoints, following the instructions here I was able to emulate the JWT token sent by Atlassian as part of the migration process, and test them by myself via Postman skipping Atlassian’s intervention.

1 Like