Last updated Sep 18, 2024

Changelog

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.

18 September 2024

Announcement User Email APIs are now accessible on Forge

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.

More details

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.

10 September 2024

Announcement Adopting Forge from Connect is now generally available

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

More details

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.

4 September 2024

Deprecation Notice Deprecation of iconUrl parameter for Change Priority and Update Priority REST APIs

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}

More details

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" }

2 September 2024

Deprecation Notice Assets for Jira Service Management cloud will have a new limit of 2 unique constraints per object type

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.

More details

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.

27 August 2024

Removed Removal of lenient URL path processing for OAuth 2.0 requests

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.

21 August 2024

Announcement Additional IP ranges for Atlassian Cloud

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.

More details

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.

16 August 2024

Deprecation Notice Assets for Jira Service Management cloud will have a new limit of 120 attributes per object type

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.

More details

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.

Deprecation Notice Assets for Jira Service Management cloud will have a new limits on URL, Email and Select attributes

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.

More details

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.

12 August 2024

Added Internationalisation is now compatible with Connect apps adopting Forge

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.

Added Cloud App Migration webhooks are now compatible with Connect apps adopting Forge

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.

More details

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.

5 August 2024

Early Access Rovo agents and actions on Forge (EAP)

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.

2 August 2024

Announcement Updated end date for deprecation of lenient URL path processing for OAuth 2.0 requests

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.

Announcement New UI Kit components

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

1 August 2024

Added License state selection for Forge install command

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.

29 July 2024

Removed Removal of the SEN field in the Connect install payload

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: