Get to know Assets

On this page

Still need help?

The Atlassian Community is here for you.

Ask the community

Starting with Jira Service Management 5.3, our asset and configuration management tool is getting a new name: Assets. While we’re moving away from the old name— Insight—Assets will still give you the same great functionality you’re used to. Read on to see what we’re changing and what you can do with Assets.

What is Assets?

Assets, previously known as Insight, is a tool that lets you keep track of everything that makes up your organization—from employees, to keyboards, servers, network adapters, offices, or even services, such as payroll or billing. If you need a place to store information about any person or object, Assets is there to lend a helping hand. It comes bundled with Jira Service Management, so you have everything in one location.

New to asset and configuration management in Jira Service Management? Learn how to get started with Assets.

What’s changing?

Insight will automatically change to Assets after you upgrade to Jira Service Management 5.3. You don’t need to do anything to see the new name. Read on to find out what you can expect after the upgrade.

Visual changes

The name Assets will now appear everywhere you used to see Insight—navigation, buttons, role names, settings, Jira automation, and documentation.

  

What about IQL and my existing queries?

We’re also rebranding Insight Query Language (IQL). IQL is now called Assets Query Language (AQL). In JQL advanced search, the new name of iqlFunction is aqlFunction. Don’t worry about the queries you’ve created in the past, though—iqlFunction will still work and so will your queries.

Integration apps

Atlassian Marketplace apps will also use the new name, so Insight Integration apps are now becoming Asset Integration apps. But just like the Assets tool, your marketplace apps will still work the same way they always have.

Assets Public REST APIs

Our public REST APIs are part of the rebranding process as well. All existing endpoints and parameters will still work as expected. However, if you have any custom integrations that use the public REST API, we recommend migrating to the new endpoint and parameters and testing your integrations to make sure their behavior hasn’t changed. Here’s what we’re rebranding:

  • /rest/insight/1.0/.... is rebranded into /rest/assets/1.0/....

  • Any /rest/insight/1.0/.../iql... endpoints are rebranded into /rest/assets/1.0/.../aql...

  • Any JSON request with an iql parameter will now support a qlQuery parameter that does the same thing. However, iql will still work for backward compatibility.

  • Any JSON response with an iql attribute will still return this attribute, so that existing integrations do not break. However, the JSON response will now also return a qlQuery attribute alongside the iql attribute, with the same value, to encourage the transition.

Last modified on Oct 18, 2022

Was this helpful?

Yes
No
Provide feedback about this article
Powered by Confluence and Scroll Viewport.