'Value for the cityId is invalid' while updating a user via Jira Align API

Platform Notice: Cloud and Data Center - This article applies equally to both cloud and data center platforms.

Support for Server* products ended on February 15th 2024. If you are running a Server product, you can visit the Atlassian Server end of support announcement to review your migration options.

*Except Fisheye and Crucible

Summary

The user is associated with a city but that city is not associated with any region in the admin settings.

While updating any field of a user with the API PATCH operation, even if the user is already set with a Region, it throws the error "Cannot update user with id <xx>. Value for the cityId is invalid"

Solution

When adding a new City, it’s mandatory to set up a Region. The Jira Align installation comes with pre-defined cities, but none of them are tied to a Region.

To fix the problem, go to Jira Align Setting > Setup > Cities and add a Region for every city.

You can also create new Regions under Jira Align Setting > Setup > Regions.

Updated on April 14, 2025

Still need help?

The Atlassian Community is here for you.