1. Creating an API Token
To create API Token navigate to My Profile > API Tokens.Click create new token and choose UNIQUE label.



Remember to save returned token or you will loose access to it forever


2. Admin API Token management
Jira Admins have access to API Tokens of all users. Admin can invalidate all token of one user or individual token.


3. Invalidating API Token
API Token may be invalidated. Invalidation of API token prevents further use of the API Token




4. Obtaining base URL
You have to obtain JWT from any request to /cloudmanager made from your JiraUsing endpoint:
https://cloud.softwareplant.com/cloudmanager/bigpicture/where-am-i
With Authorization header set to:
APIToken <obtainedApiToken>Will return location e.g. https://cloud.softwareplant.com/bigpicture/jiracloud/101

Curl example:

curl --location --request GET 'https://cloud.softwareplant.com/cloudmanager/bigpicture/where-am-i' \

--header 'Authorization: APIToken <<Your API Token>>'
CODE

5. Using API token
You can create full URL using baseUrl you obtained in 4. by combining it with actual application endpoint
https://cloud.softwareplant.com/bigpicture/jiracloud/101/rest/system/user/current/profile/data

Curl example:


curl --location --request GET 'https://cloud.softwareplant.com/bigpicture/jiracloud/108/rest/system/user/current/profile/data' \

--header 'Authorization: APIToken <<Your Api Token>>'
CODE

Best practices:

  • It's highly suggested to create dedicated Jira user for integration purpose. Add Application access to this user and generate API tokens using him.