Learn how to connect to the Assets API
You can fully exploit all functionalities of the Extension app by establishing a connection with Assets API.
The connection is required for including the Assets custom field into your Dynamic Forms. Users with no access to the Assets API won’t be able to add the field while creating dynamic request forms.
Note that in order to use Assets in Jira Service Management it’s required to upgrade to the Premium Plan.
Due to ongoing platform improvements, certain views presented in documentation may not fully reflect the latest in-app changes. We’re actively updating our content to match the new experience.
In order to connect to the Assets API, start with accessing the Assets API configuration view.
Before you start, log in as a user with Jira Administrators global permissions. For more information, see Atlassian documentation.
If you can’t display Extension for Jira Service Management on the sidebar, make sure you’ve upgraded to the latest version of the app.
You are redirected to the view with the Assets API configuration. The next step is to establish the connection by using your Atlassian account credentials.
You can establish your connection with the Assets API by using your Atlassian account credentials:
API tokens serve for authentication allowing users to securely work with the app. The tokens can be generated from your Atlassian account. You can use your generated token by applying the copy and paste options.
To find out how to create and manage API tokens, see Atlassian documentation.
Bear in mind that the approach of connecting to the Assets API is not recommended by Atlassian. Providing your Atlassian account credentials can be done at your own risk.
The introduced email and API token are verified. If your credentials are correct, the connection is established.
If your connection with Assets API can’t be established, you’ll be immediately notified about the reason. Depending on the connection problem, you can see a different label under the Connection status section:
If you’ve introduced wrong credentials, the connection with the app can’t be established. In this case, you’ll see the Error label under the Connection status section.
To resolve your problem with connection, try following the steps below:
Your connection is established and the app functionalities are available when the label under the Connection status section is changed to Connected.
If you’ve used a token that is no longer valid, the connection with the app can’t be established. As a result, you’ll see the Token Expired label under the Connection status section.
To learn about solving this problem with connection, follow the below steps:
By default, API tokens are valid for a week. If you wish your token to last longer, select a proper date by filling in the Create an API token view.
Remember that tokens can be generated for no longer than a year.
Your connection is established and the app functionalities are available when the label under the Connection status section is changed to Connected.
You can terminate the established connection anytime simply by disconnecting Assets API.
By terminating your connection with the Assets API you will have limited access to the app features. Users with no access to the Assets API won’t be able to include the Assets field while creating dynamic request forms.
The connection with the Assets API is terminated. You can establish a new connection by providing your API token and email address later.
If you can’t find the answer you need in our documentation, raise a support request. Include as much information as possible to help our support team resolve your issue faster.
Back to App page