REST APIs

These APIs are here to help you edit and view your data. But before you can use them, you need a special token called JWT for authorization.

Prerequisites

• You must be an AIP administrator or Jira administrator to carry out the instructions on this page.

Create a new token

1. In the top bar, navigate to Settings.

2. From the side menu, select API Token.

3. Click New Token to generate a new token.

   Open

   

4. Name your token, select when it'll expire, or check the Never expire box to make sure the token doesn’t expire in a certain time period, and how much access it will have. Click Save.

   Open

   

5. The JWT Token will appear. Save it by clicking the icon shown below. Keep in mind that you won’t be able to access this code after closing the pop-up.

6. Click Cancel after copying the token, and the token will appear on the main page.

7. Replace {{jwtToken}} in the header with your token.

Give JWT permission

Here is how you can give JWT authorization using Postman.

1. Open the AIP REST APIs documentation.

2. Click Run in Postman > Postman for Web.

3. On the Postman main page, click Workspaces > My Workspaces.

4. Click to add a new permission.

5. Here, to give authorization, first copy and paste the link of the token you’ve chosen from here.

6. Click Headers.

7. Under KEY, write Authorization.

8. Under Value, write “Bearer (paste the token you’ve created and copied)”

9. Click Send.

10. Tada! You’ve successfully given the JWT authorization.

REST call example

For better comprehension, we included definitions for some values of an example response below.