Last updated Dec 7, 2021

Rate this page:

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 Cloud Platform.

Forge changelog

For updates about changes to the Forge platform, see the Forge changelog in the Forge documentation.

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.

7 December 2021

Added Jira project settings page module

Jira Cloud adds support for the project settings page module. This module adds an item to the project settings sidebar. When the item is clicked, content is rendered on a new Jira page. Use the UI kit or custom UI to create content for the Jira page.

This module can be used in Jira Core, Jira Software, and Jira Service Management.

Run npm install @forge/ui@latest on the command line in your app directory to install the latest
version of the UI kit.

Added Jira global page module

Jira Cloud adds support for a global page module. This module adds an item in the Apps section of the main navigation. When the menu item is selected, content is rendered on a new Jira page. Use the UI kit or custom UI to create content for the page.

This module can be used in Jira Core, Jira Software, and Jira Service Management.

Run npm install @forge/ui@latest on the command line in your app directory to install the latest
version of the UI kit.

3 December 2021

Announcement Documentation for rotating refresh tokens

We’ve added documentation about:

  • detection of any rotating refresh tokens being reused

  • the absolute lifetime, inactivity lifetime, and leeway of rotating refresh tokens

  • implications of migrating to rotating refresh tokens and rolling back to persistent refresh tokens

  • possible causes of and debugging the 403 Forbidden (invalid_grant) error

2 December 2021

Deprecation Notice Epic link, parent link, and other related fields in REST APIs and webhooks

We're deprecating the epic link, parent link, epic, and other related fields and events in the Jira REST API and webhooks. They will be removed from the REST API and webhooks on 31 May 2022.

The scope of this change is the Jira REST API and webhooks only. The deprecation does not apply to these fields in Jira UI.

For a breakdown of the affected operations and webhooks, see the announcement in the Developer Community.

1 December 2021

Deprecation Notice "contextId" parameter in "Issue custom field configuration (apps)"

The field and query param contextId in the Issue custom field configuration (apps) operation is deprecated and replaced with:

  • id, the ID of the configuration entry, which behaves in the same way as the deprecated contextId. Note, this is not the ID of the field context the configuration is associated with, contrary to the previous name.

  • fieldContextId, a reference to the field context ID the configuration is associated with.

The reason for this change is that while contextId was intended to be a reference to a field context ID, in some cases it wasn't. fieldContextId serves this purpose now.

The straightforward way of updating your app is to replace contextId with id, making everything work the same as before. However, do check whether fieldContextId is the field that you should use instead.

The contextId field and query param will be removed on 1 March 2022.

25 November 2021

Announcement Updated deprecation date for persistent refresh tokens

We previously announced the deprecation date of persistent refresh tokens as 30 November 2021.

We’ve updated this deprecation date to be 31 January 2022 instead.

24 November 2021

Fixed Minor change to endpoint for deleting custom field options

Issue data clean up is now done asynchronously while the option remains being deleted synchronously. Overall, it should have no impact to the consumers of the API.

19 November 2021

Added Custom context variables in Jira expression evaluation

The ability to pass custom context variables in requests to evaluate Jira expressions in the REST API has been added.

See the Evaluate Jira expression operation documentation for more details.

Added Certain Jira modules can now access their issue's typeId

The following Jira modules can now access their issue’s typeId:

8 November 2021

Fixed Updated URIs for avatars, attachments, and attachment thumbnails

We’re updating the way in which avatars, attachments, and attachment thumbnails are referenced in response objects. These items will be represented by URIs for the appropriate REST API operation, rather than using non-REST URIs. These changes are to ensure that the appropriate OAuth scope checks are made when these objects are requested.

We expect all the affected operations to reach all production instances by January 14, 2022.

See the announcement for more details.

2 November 2021

Announcement Reuse detection interval for rotating refresh tokens

We’ve updated the leeway or reuse detection interval of rotating refresh tokens, from three seconds to 10 minutes.

1 November 2021

Added Support for migrating Connect app listings and installations to Forge

You can now migrate your Connect app listing and installations to Forge. Navigate to the management view of your Marketplace listing, then select a Forge app with a matching app.connect.key as the new version.

Admins of sites that use your app’s Connect version will be prompted to update to the Forge version (in the “Manage Apps” screen). When they accept, the installation will be replaced by the Forge version.

You can request a staged rollout of the upgrade by raising a Marketplace support ticket listing which sites see the upgrade.

See Migrate an app from Connect to Forge for more information on how to migrate your app (including known issues and limitations with doing so). Then, see Listing a Forge successor to a Connect app for information on how to update your listing with a migrated app.

19 October 2021

Added Comment created webhook now also has an event type field

The comment_created webhook now has a new field eventType which conveys the source of the event. The field can have three values

  • partOfIssueChange: The comment was added as part of editing an issue field.

  • partOfWorkflowEvent: The comment was added as part of a workflow transition.

  • primaryAction: The comment was added as the main action.

Use this field to ignore any webhook events based on how the comment was created. For example, you can ignore any events with partOfIssueChange event type if the comments added as part of the Issue edit screen are unnecessary. Similarly, you can use partOfWorkflowEvent event type to ignore comments added as part of the Workflow transition screen.

18 October 2021

Added Update custom fields operation

Introduction of the Update custom fields operation to update the value of one or more custom fields on one or more issues. Custom fields can only be updated by the Forge app that created them.

See REST API documentation for more details.

17 October 2021

Deprecation Notice Removal of web fragment locations in new Jira Cloud experience

As the new Jira Cloud experience rolls out, several locations for providing content in the Jira Cloud user interface have evolved and been replaced with new APIs. The items removed are the project tab panels, profile tab panels, and project admin summary panels.

See Removal of web fragment locations in new Jira Cloud experience for more detail.