Hi everyone,
We’re developing a Jira Cloud app (Connect/Forge) and we’re seeing unexpected behavior with user properties that we’d like to clarify.
Our setup:
- When a user logs into our app for the first time, we set a user property on that user via the User Properties REST API (
POST /rest/api/3/user/properties/{propertyKey}). - We remove this property only when the user is deleted from Jira (we listen to the
user_deletedwebhook). - We also track the
user.activefield on everyuser_updatedwebhook, so we know which users are deactivated.
The issue:
We’ve discovered that some users with active: false are missing our user property, even though our app never removed it. We’ve audited all of our property-removal logs on our side, and we’re confident our code did not delete these properties.
This leads us to believe that Jira may be removing user properties automatically on its side — possibly when a user is deactivated, or during some other lifecycle event.
Questions:
- Does Jira Cloud automatically delete user properties when a user is deactivated (
active: false)? - Are there any other scenarios where Jira removes user properties automatically without any action from the app that created them? For example:
- User deactivation/reactivation
- User deletion and the 14-day grace period
- App uninstall/reinstall
- Site import/migration
- License changes or the user losing product access
- If automatic removal does happen, is there a webhook or event we can listen to so we can react to it?
Any confirmation from Atlassian or pointers to documentation describing the user property lifecycle would be greatly appreciated.
Thanks in advance!