Last updated Mar 28, 2022

Rate this page:

Changelog

This page includes release notes and updates for app developers working against the Insight API. Use this page to keep track of upcoming changes, deprecation notices, new features, and feature updates from Insight.

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 developers are announced.

28 March 2022

Added New 3LO App Controls for Site Admins

An improvement will be made in the coming days to allow customers (site admins) to turn off (or back on) end-user installation capabilities for OAuth 2.0 (3LO) apps. If you are a developer of OAuth 2.0 (3LO) apps, you do not need to take any action as a result of this change, as this message is only to communicate the impact to the customer.

More details

Previously, controls were not in place for an admin to block their users from installing 3LO apps. Adding the ability for an admin to prohibit users from installing 3LO apps now aligns more closely to how a user would install any other, non-3LO apps on the Marketplace. This functionality was requested by several Atlassian enterprise customers to gain increased control over where their data is shared and which apps have access to their instance. By allowing admins to control end-user app installs, we are making it possible for more enterprise customers to move to cloud. Once in cloud, these companies will not be blocked from installing 3LO apps, because admins will retain the ability to vet and install the apps at their discretion.

Figure (a) below demonstrates the section of the customer’s admin console where they will now be able to block their users from installing 3LO apps. Figure (b) below shows the new experience when a customer tries to install a 3LO app after their admin has disabled this function.

If a customer attempts to install a 3LO app after their admin has disabled this function, the following error message will appear:

App is blocked by an admin
An admin has not allowed [App Name] to access data from [Your Atlassian Instance] . Select another site to authorize access to or contact your admin for more information.

(a)

(b)

13 December 2021

Added Custom icons for external imports

External imports can now define and use their own set of icons.

3 December 2021

Added External imports referenced object support

External imports can now define object reference attributes in their schema and mapping configuration and push object references in the data.

Added External imports PATCH endpoint for schema and mapping

The "mapping" endpoint for external imports now supports PATCH invocations that specify incremental updates to be performed on the schema and mapping configuration.

14 May 2021

Added External imports

We published a new set of APIs to allow external applications to import data into Insight.