# Jira

{% hint style="info" %}
Dropzone's integration is only with the Jira Cloud, however support for on-prem Jira Datacenter is on the roadmap.
{% endhint %}

The Dropzone platform supports [Jira](https://confluence.atlassian.com/jira), a project management and issue tracking tool from Atlassian.

## Create an API Key

Jira requires an API key to enable. The API key is associated with an account, so you may wish to create a dedicated service user rather than using your own.

To obtain an API Key, do the following:

* Log into your Jira account e.g. https\://*mycompany*.atlassian.net as the API user for Dropzone AI
* Click on your user icon and click "Manage Account"

<figure><img src="/files/OvKYfe26C8hNJ2JzlJKl" alt=""><figcaption><p>Go to "Manage Account"</p></figcaption></figure>

* In the top banner, bavigate to "Security"

<figure><img src="/files/j2PtR79iEESwbh6lMbst" alt=""><figcaption><p>Navigate to "Security"</p></figcaption></figure>

* Under "API tokens," click "Create and manage API tokens"

<figure><img src="/files/o2DgsE4lLAdZqyssaagv" alt=""><figcaption><p>Click "Create and manage API tokens"</p></figcaption></figure>

* Click "Create API token"

<figure><img src="/files/YIfI69lZBcrrotPGMD2b" alt=""><figcaption><p>Create API token</p></figcaption></figure>

* Enter a name to identify the API key, such as Dropzone.ai, then click "Create"

<figure><img src="/files/inY8UjUmZhImrM2WKfJ2" alt=""><figcaption><p>Create API token</p></figcaption></figure>

* Store the API token shown in a secure location for use later in the Dropzone UI where it is called "API Token"

<figure><img src="/files/qroUH4dhTIGVszUf1JBQ" alt=""><figcaption><p>Copy API token</p></figcaption></figure>

## Enable Jira

To enable the Alert Source integration, you will need the following information:

| Dropzone Field | Source                                                                    |
| -------------- | ------------------------------------------------------------------------- |
| Server         | The same as your company server url in Jira, eg *mycompany*.atlassian.net |
| Username       | The username of the account that created the API                          |
| API Token      | The API token value you generated earlier                                 |

To enable the Alert Source integration, do the following:

* Navigate to your Dropzone AI tenant home page e.g. https\://*mycompany*.dropzone.app
* In the bottom left hand corner, navigate to Settings > Integrations

<figure><img src="/files/zN02u3HObDaemUY8E1kD" alt=""><figcaption><p>Integrations Dropdown</p></figcaption></figure>

* Click "Available"

<figure><img src="/files/brI7n2Ux40Tk0jTwBCVh" alt=""><figcaption><p>Click Available</p></figcaption></figure>

* In the Search bar, search Jira, then click "Configure"

<figure><img src="/files/hp3fx5SdeVP3vmXgdFqq" alt=""><figcaption><p>The Jira Tile</p></figcaption></figure>

* Under the Alert Source heading, input the Server, Username, and API Token
* In the "Ticket alert workflow" section, select an option from the "Alert Extraction Strategy"
  * Ask your Dropzone support representative if you do not know which to use

<figure><img src="/files/GXOwe9mp60yWcgkvXGRA" alt=""><figcaption><p>The Jira Alert Source configuration (pt 1)</p></figcaption></figure>

* Under "Jira Issue Filter," you must input a Jira [JQL](https://support.atlassian.com/jira-service-management-cloud/docs/use-advanced-search-with-jira-query-language-jql/) search query to identify Jira tickets that contain alerts to investigate
* If you want Dropzone to push its investigation results back to Jira, check the box labeled "Comment Investigation Results to ticket"
* Input your desired Poll interval and lookback

<figure><img src="/files/zYRKhkF1JWkXDZ6joGlb" alt=""><figcaption><p>The Jira Alert Source configuration (pt 1)</p></figcaption></figure>

* Click "Test & Save" to finish

If you have any errors engage your Dropzone AI support representative.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.dropzone.ai/integrations/alert/jira_alert.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.