This page includes release notes and updates for Jira Cloud app developers. Use this page to keep track of upcoming changes, deprecation notices, new features, and feature updates from Jira Service Management Cloud.
Go to our developer community to ask questions. You may also be interested in the What's New blog for Atlassian Cloud where details of major changes that affect all users of the Jira Cloud products are announced.
Forge apps can now access the Get User Email and Get User Email Bulk APIs on Jira and Confluence when declaring the read:email-address:jira
or read:email-address:confluence
scopes.
Access to the Get User Email and Get User Email Bulk APIs is only supported when making asApp()
requests. Requests made asUser()
are not compatible with these APIs.
Learn more about profile visibility on Forge apps here.
Following its preview release back in February, Adopting Forge from Connect is now generally available.
The majority of apps can now incrementally adopt Forge with their existing Connect apps. The remaining apps will be able to do so when Data Residency support is available for Forge Remotes.
Learn more in our blog post - Connect apps will gain new extensibility features through Forge
Existing Connect apps now have a simpler, automated and incremental pathway to adopt Forge capabilities. This release includes:
Automated tooling to support the conversion from Connect to Forge
Support for immediate version updates of Forge apps containing connectModules
Increased compatibility for the types of connectModules
that can be declared within a Forge manifest
Support for Forge Remote Compute (preview) in the Atlassian Connect Express (ACE) and Connect Spring Boot (ACSB) frameworks.
We have previously allowed the creation of priorities with an iconUrl parameter, which specifies the location of the icon image to be used when displaying the priority.
We are now moving towards using avatars, which will be uploaded using a separate API. Users will then be able to supply the avatarId to specify the avatar used when displaying the priority.
We are therefore deprecating the use of “iconUrl” as a parameter to the following REST APIs:
POST /rest/api/2/priority
POST /rest/api/3/priority
POST /rest/api/latest/priority
PUT /rest/api/2/priority/{ID}
PUT /rest/api/3/priority/{ID}
PUT /rest/api/latest/priority/{ID}
When making a request to:
POST /rest/api/*/priority
or
PUT /rest/api/*/priority/{id}
use avatarId
instead of iconUrl
.
Note to get an avatarId, use the Load avatar API to upload an avatar and get a avatarId.
e.g.
instead of:
1
2
3
4
5
6
{
"description": "My priority description",
"iconUrl": "images/icons/priorities/major.png",
"name": "My new priority",
"statusColor": "#ABCDEF"
}
adopt the following request:
1
2
3
4
5
6
{
"description": "My priority description",
"avatarId": "1231",
"name": "My new priority",
"statusColor": "#ABCDEF"
}
After 31st of October 2024 we will be introducing a new limit of 2 unique constraints per object type. For customers with any existing object types that already have more than 2 unique constraints, we are asking these customers to please reduce these to 2 per object type before 31st of October 2024.
At present an object type in Assets for Jira Service Management can have an unbounded number of unique constraints applied to its attributes. After 31st of October 2024 we will be introducing a new limit of 2 unique constraints per object type. This is part of our effort to offer a more scalable, performant and reliable experience as we make major enhancements to the underlying platform that powers Assets. We believe this new limit will be sufficient for the vast majority of use cases in which Assets is utilised.
For customers with any existing object types that already have more than 2 unique constraints, we are asking these customers to please reduce these down to 2 per object type before 31st of October 2024. Not doing this will mean:
When we are ready to begin moving you to the new Assets platform, we will be unable to do so without first disabling your unique constraints on any object type with more than 2.
You will be able to re-enable up to 2 per object type after this is completed.
More information on this process will be released in future.
Effected public Assets REST API endpoints are:
Both of these endpoints will begin to return a HTTP status code of 400 if there is an attempt to add a unique attribute constraint (via the uniqueAttribute
property) and the limit has been reached.
If you have more than 2 attributes on an object type that you need to ensure are unique, a potential workaround is creating an automation rule to check the number of objects that can contain a particular value after an object is updated. You could then raise a Jira issue to resolve the duplicate or notify the relevant schema administrator.
By making these changes we can ensure your site can begin to utilise our improved Assets platform when it is completed and reap the vastly improved the scalability, performance and reliability it will offer. We’ll be announcing more about this soon.
Rollout: progressive roll-out by request. COMPLETE
The extended period for deprecation of lenient URL path processing for OAuth 2.0 requests has now expired. This deprecation will be rolled out progressively over the next few days.
We're announcing new IP ranges that will soon be available for requests from external clients, such as browsers and API integrations:
13.35.248.0/24
13.227.180.0/24
13.227.213.0/24
These ranges won't be used to make outgoing connections from Atlassian Cloud to remote systems, for example, webhooks.
To prepare for this change, update your firewalls and other security measures to allow connections to the new IP ranges.
For more information, see IP addresses and domains for Atlassian Cloud products, which includes instructions on how to receive notifications of changes, as well as links to machine-readable lists of our IP ranges.
After 30th of September 2024 we will be introducing a new limit of 120 attributes per object type. For the few customers with any existing object types that already have more attributes than this new limit, we are asking these customers to please reduce these numbers down to no greater than 150 per object type before 30th of September 2024.
At present an object type in Assets for Jira Service Management can have an unbounded number of attributes. After 30th of September 2024 we will be introducing a new limit of 120 attributes per object type (which also includes any attributes inherited from a parent object). This is part of our effort to offer a more scalable, performant and reliable experience as we make major enhancements to the underlying platform that powers Assets. We believe this new limit will be sufficient for the vast majority of use cases in which Assets is utilised.
For the few customers with any existing object types that already have more attributes than this new limit, we are asking these customers to please reduce these numbers down to no greater than 150 per object type before 30th of September 2024. If you are one of these customers we’ll be reaching out to you to see if we can help in any way.
By making these changes we can ensure your site can begin to utilise our improved Assets platform when it is completed and reap the vastly improved the scalability, performance and reliability it will offer. We’ll be announcing more about this soon.
After 30th of September 2024 we will be introducing new limits regarding URL, Email and Select attributes. The limits are:
A maximum cardinality of 50 for attributes with multiple values, OR
A total of no more than 2700 characters for all values within an attribute (single or multiple values)
Whichever is reached first.
For Select attributes these limits apply to both attribute values and options.
For the few customers with existing data that breaches this limit, we are asking these customers to please adjust their data to align with the limits by 30th of September 2024.
After 30th of September 2024 we will be introducing new limits regarding URL, Email and Select attributes. The limits are:
A maximum cardinality of 50 for attributes with multiple values, OR
A total of no more than 2700 characters for all values within an attribute (single or multiple values)
Whichever is reached first.
For Select attributes these limits apply to both attribute values and options.
For example this would mean that if a URL, Email or Select attribute had 50 values, then each value can on average contain 54 characters.
This is part of our effort to offer a more scalable, performant and reliable experience as we make major enhancements to the underlying platform that powers Assets. We believe these new limits will be sufficient for the vast majority of use cases in which Assets is utilised.
For the few customers with existing data that breaches this limit, we are asking these customers to please adjust their data to align with the limits by 30th of September 2024. If you are one of these customers we’ll be reaching out to you to see if we can help in any way.
By making these changes we can ensure your site can begin to utilise our improved Assets platform when it is completed and reap the vastly improved the scalability, performance and reliability it will offer. We’ll be announcing more about this soon.
Connect modules in Connect apps adopting Forge can now support internationalisation. The latest version of the connect-to-forge
package will copy over the translations
field in a Connect descriptor to a Forge manifest as connectModules.jira:translations
or connectModules.confluence:translations
based upon the product.
For more information, refer to Incrementally adopting Forge from Connect.
Connect modules in Connect apps adopting Forge can now support statically declared Cloud App Migration webhooks. The latest version of the connect-to-forge
package will copy over the cloudAppMigration
field in a Connect descriptor to a Forge manifest as connectModules.jira::cloudAppMigration
or connectModules.confluence::cloudAppMigration
based upon the product.
For more information, refer to Incrementally adopting Forge from Connect.
The Cloud App Migration support in apps adopting Forge from Connect will continue to only support the migration of Connect modules. For more details, please refer to Limitations and Differences.
Atlassian Rovo is Atlassian’s newest product which unlocks enterprise knowledge powered by generative AI.
The new Forge modules, Rovo agents and Action allows you to build interactive apps by integrating custom AI agents that interpret prompts using LLMs and perform tasks through predefined actions.
To get started, see :
To start using this EAP, sign up using the Forge EAP form.
The deprecation of lenient URL path processing for OAuth 2.0 requests has now been unblocked for Forge apps with installations on multiple major versions by support for backporting. These apps were previously blocked from deploying fixes.
In the latest version of @forge/react
(version 10.5.0), we are releasing a new set of UI Kit components alongside a few changes to existing components.
We are releasing the following new UI Kit components into Preview:
List
CheckboxGroup
Calendar
TimePicker
InlineEdit
Popup
EmptyState
For existing components, the following changes are being made:
Tag component now includes href
prop
Icon component now includes primaryColor
and secondaryColor
props
For more information on the capability of these components, please find the corresponding component documentation
To update your UI Kit app to the latest version, in the terminal of your project directory, run the following command:
npm install --save @forge/react@latest
We’ve introduced a new --license
option to the forge install
command.
This enhancement lets you specify and test different license states for Forge apps in non-production environments, providing greater flexibility and control during the development and testing phases. This essentially means that you no longer have to mock your app code as if it’s in production to test your Forge app in different license states.
The following license values are supported:
active
inactive
trial
See Listing Forge apps and Forge CLI reference documentation for more details.
As per https://community.developer.atlassian.com/t/changes-to-sen-availability-in-connect-app-install-payload/54596, the SEN field in the Connect app install payload has been removed.
All apps should now be using the new identifiers discussed in https://community.developer.atlassian.com/t/introducing-new-cloud-identifiers/49814.
Rate this page: