This API is dedicated to integration between Jira and third-party systems and allows for the extraction of data such as SLA metic state, history, etc.

URL

Integration API is available at slaapp.almarise.com

Authentication

Basic authentication is used to authenticate calls. You will need an email address connected to the Atlassian account and a security token.

The security token is generated from your Atlassian account. This is how to set up a personal access token step-by-step:

  1. Log in to your account and navigate to the Security tab → API tokens → click on "Create and manage API tokens".

  2. Click "Create API token".

  3. Fill in the Name of the token and set the Expiration date → click Create.

  4. Copy the token. 

Requests 

Before making API call, you have to set 3 request headers:

  • Source-System - JIRA

  • Jira-Host - address of your Jira Cloud instance

  • api-token - token generated via your Atlassian account. 

Before you start

To make API calls you'll need to provide an issue ID and (in certain cases) SLA metric ID.

Find out how to identify the Jira Issue ID in Cloud

SLA metric ID can be obtained by using some endpoints e.g. GET/integration/V1/metrics-state/{ticketId}/metrics


An example of integrating SLA PowerBox API with Automation for Jira.

List of Endpoints

  • Metric-state:
    • /integration/V1/metrics-state/{ticketId}
    • /integration/V1/metrics-state/{ticketId}/metrics
    • /integration/V1/metrics-state/{ticketId}/{slaMetricId}
  • Metric-history:
    • /integration/V1/metrics/history
  • SLA-event-processor:
    • /integration/V1/sla-custom-event/add
    • /integration/V1/sla-custom-event/add/multiple
    • /integration/V1/sla-custom-event/list/full
    • /integration/V1/sla-custom-event/list
    • /integration/V1/sla-custom-event/list
  • No labels