Authorization

Authorization

Basic authentication is accepted for user authorization. Basic auth requires API tokens. API tokens are generated and managed by navigating to Cog icon → Marketplace apps → API tokens in the left sidebar under STAGIL Assets.

image-20260406-182557.png

Username. Token labels are used to create a username for a REST client. The username has the following format: tokenLabel@instanceName.atlassian.net.

Password. The password is API token itself. For example, Y71AteRwSra1keDalEvp0Y

You can also use our Postman collection for this and define {{tokenLabel}}, {{instanceName}} and {{apiToken}} as variables.

Authorisation for Automation rules

Authorisation header for web requests uses the same information but in a slightly different construct.

Below you can see an example of a constructed authorisation header:

Authorization: Basic user@stagil-test.atlassian.net:TDTJ9mu06roWwkLqUmlh45

where 

user = token label 
stagil-test.atlassian.net = your instance URL 
TDTJ9mu06roWwkLqUmlh45 = token 

Next, the string user@stagil-test.atlassian.net:TDTJ9mu06roWwkLqUmlh45 should be encoded via Base64.

The last step is to fill out the header with an encoded string as shown in the example to the right.

image-20260406-183848.png