Connect to Jira assets

Prerequisites

• Have a Jira Cloud Premium

• Have Elements Connect installed on your instance

• Have created Jira assets

Steps

1. Discover your Workspace ID

2. Configure the Elements Connect datasource

3. Endpoints examples

1. Discover your Workspace ID

 The Jira Service Management REST API uses the workspaceId to identify your individual instance of Assets. You must include the Workspace ID when making any calls to this REST API.

You can discover your Workspace ID through the following endpoint:

https://YOUR_JIRA_BASE_URL/rest/servicedeskapi/assets/workspace

Replace YOUR_JIRA_BASE_URL according to your own Jira instance

Your workspace ID can be found here:

2. Configure the Elements Connect datasource

• Go to Elements Connect administration by clicking on “Apps”, then Elements Connect:
  

• Click on “Create datasource”:
  

• Select “REST API”:
  

• Give your datasource a name, and configure it as follows:

  • Server Details:
    • API Base URL: 

      https://api.atlassian.com/jsm/assets/workspace/YOUR_WORKSPACE_ID/v1

      replace YOUR_WORKSPACE_ID accordingly
      
    • API Documentation:

      https://developer.atlassian.com/cloud/assets/rest/api-group-object/#api-object-id-get

    • API Test URL:

      https://api.atlassian.com/jsm/assets/workspace/YOUR_WORKSPACE_ID/v1/objectschema/list

      replace YOUR_WORKSPACE_ID accordingly
      
      
  • Authentication:
    • Mode: Basic
    • Login: user login used to connect to the current Jira site
    • Password: enter a token that can be generated here: https://id.atlassian.com/manage-profile/security/api-tokens (click on "Create API token")
      

  • Click the “Test connection” button:
    

  • Save your datasource configuration. You’re all set!

3. Endpoints examples

Once your datasource is ready, you can create connected fields and retrieve different types of information.

All available endpoints are listed in this documentation: Assets REST API

Here are some examples:

a. Get all available assets

b. Get all available schemas

c. Get all object types belonging to a specific schema