Announcement — Introducing 'App User' type on Feb 9, 2023
To support the development of a new feature, we're introducing a new subtype of the Account definition called App User into the Bitbucket Cloud API. After a 6-month deprecation period, ending on Feb 9, 2023, any API which documents an Account type can start returning App User objects, along with the currently expected Team and User objects.
Why we’re adding the App User type
The App User type represents a new type of Bitbucket Account used by certain integrations and apps. The App User type shares the vast majority of its fields with the User type. However, it has some unique fields so we decided to create a new subtype of Account instead of overloading the User type.
Note that you won’t be able to directly create App User objects via our REST API.
We've included the App User definition in our swagger.json to allow vendors and users to integrate with the new data structure prior to the release date.
The app_user schema
"title": "App User",
"description": "An app user object.",
"description": "The user's Atlassian account ID."
"description": "The status of the account. Currently the only possible value is \"active\", but more values may be added in the future."
"description": "The kind of App User."
What action is required?
Although there are many endpoints impacted by these changes, the actual changes should require little or no action from most developers. If you use our swagger.json file to auto-generate client code, you may wish to regenerate your client code.
The app_user object can be treated in an identical manner to a user object, unless you wish to differentiate them. They both share the account_id, account_status, uuid and display_name fields which are the primary fields used.
Which schema objects are affected?
May return the new App User subtype.
Base Commit changes
The author field may return the new App User subtype.
Branch Restriction changes
The users array field may return the new App User subtype.
The groups array field refers to type Group which has changes (See Group changes)