> ## Documentation Index
> Fetch the complete documentation index at: https://docs.airmdr.com/llms.txt
> Use this file to discover all available pages before exploring further.

# JIRA

> JIRA is a popular project management and issue-tracking tool developed by Atlassian. It is mainly used for bug tracking, agile project management, and workflow automation.

To integrate JIRA with AirMDR, you need:

1. **Instance URL** – The unique URL of your JIRA instance.
2. **Email Token (API Token)** – Used for authentication in API requests.

### Generate JIRA Email Token (API Token)

JIRA API tokens allow users to authenticate API requests securely without using passwords. Here’s how to **create, manage, and revoke** API tokens in JIRA.

<Steps>
  <Step title="Access Atlassian API Token Page">
    1. Go to the Atlassian API Token Page.
    2. Log in with your **JIRA (Atlassian) credentials**.
  </Step>

  <Step title="Generate a New API Token (Email Token)">
    1. Scroll to the **API token** section.
    2. Click **"Create API token"**.
    3. Enter a meaningful label (e.g., "Integration with XYZ").
    4. Click **"Create"** and then **copy the token**.

           <Warning>
             This token is displayed only **once**. Store it securely.
           </Warning>
  </Step>
</Steps>

### Access Instance URL

1. Go to the Atlassian API Token Page.
2. Log in with your **JIRA (Atlassian) credentials**.
3. Click on your profile picture (top-right corner) → **"Profile"**.
4. Your instance URL is displayed in the browser’s address bar.

### Manage & Revoke API Tokens

<Steps>
  <Step title="Access Atlassian API Token Page">
    1. Go to the Atlassian API Token Page.
    2. Log in with your **JIRA (Atlassian) credentials**.
  </Step>

  <Step title="Revoke the Token Access">
    1. Scroll to the **API Tokens** section.
    2. You will see a list of all active API tokens.
    3. Click **“Revoke”** next to the token you want to delete.
    4. Confirm the action when prompted.
  </Step>
</Steps>

### Configure JIRA API Token in the AirMDR Integrations Dashboard

1. Navigate to [AirMDR](https://app.airmdr.com/auth/login), provide the credentials, and click **Login.**

   <img src="https://mintcdn.com/airmdr/wnBXbVlE7mmN9W6R/images/Datadog11.png?fit=max&auto=format&n=wnBXbVlE7mmN9W6R&q=85&s=94afec6835b90abcec516831e584184f" alt="" width="443" height="568" data-path="images/Datadog11.png" />
2. Navigate to the AirMDR Integrations Dashboard in the left navigation pane and select **Integrations.**\\
   <img src="https://mintcdn.com/airmdr/wnBXbVlE7mmN9W6R/images/Duo7.png?fit=max&auto=format&n=wnBXbVlE7mmN9W6R&q=85&s=eb761cfacb91ef3d08a6f7994022f6d5" alt="images/Duo7.png" width="246" height="381" data-path="images/Duo7.png" />
3. Use the search option, enter the keyword "**JIRA**", select the **Connections** tab, and click the **+ Create** icon.\\
   <img src="https://mintcdn.com/airmdr/-EZh6YrIIs69rcCd/images/Jira2.png?fit=max&auto=format&n=-EZh6YrIIs69rcCd&q=85&s=9abc95f70fd3f6c55effcd93c1874e3f" alt="Jira2 Pn" width="607" height="269" data-path="images/Jira2.png" />
4. Enter the email used to login to the JIRA account and the generated **Token,** **instance\_url** in the Authentication Details field params, and click **Create.**\\
   <img src="https://mintcdn.com/airmdr/-EZh6YrIIs69rcCd/images/Jira1.png?fit=max&auto=format&n=-EZh6YrIIs69rcCd&q=85&s=30d89b269504ec21d308094789a3baf3" alt="Jira1 Pn" width="894" height="884" data-path="images/Jira1.png" />