# Jira

Connecting Jira to DuploCloud lets the AI agent read tickets, create issues, update statuses, and act on Jira data on your behalf. You will need an Atlassian API token, your account email, and your Jira Cloud ID.

***

## Step 1 — Add the Jira Provider

In DuploCloud, go to **Providers** in the left sidebar, select your tenant (e.g. **IT**), and click the **Other** tab. Click **+ Add**.

![Other providers list](/files/qaaHiyXvap2CDtM8VcI7)

Fill in the **Add Provider** form:

* **Name** — a name for this provider (e.g. `Jira-test`)
* **Type** — select `Other`
* **Account ID** — your Atlassian domain (e.g. `your-org.atlassian.net`)

Click **Create Provider**.

![Add Provider form](/files/QO5apVxFapt2TrujjppS)

The provider is created and you are taken to the provider detail page.

![Provider created successfully](/files/sjwNENGEtYDJOF9tk4iV)

***

## Step 2 — Add a Credential

On the **Credentials** tab, click **+ Add**. Add the following credential fields:

* **`apikey`** — your Atlassian API token. Generate one at **id.atlassian.com** → **Security** → **API tokens** → **Create API token**. Set Sensitive to on.
* **`username`** — the email address associated with your Atlassian account
* **`CloudID`** — your Jira Cloud ID. To find it, navigate to `https://your-domain.atlassian.net/_edge/tenant_info` in your browser — the `cloudId` field in the response is the value to use here

Click **Create**.

![Add Credential with apikey, username, and CloudID](/files/8uQchucWHwidZuMohI1M)

***

## Step 3 — Add a Scope

On the **Scope** tab, click **+ Add**.

* **Name** — a name for this scope (e.g. `Jira-test-scope`)
* **Credential** — select the credential you just created

Click **Create**.

![Add Scope modal](/files/dLIjzzFQqH9i6bwasUVJ)

***

## Step 4 — Use the Scope in a Ticket

Go to **HelpDesk** and create a new ticket. In the scope selector, choose the Jira scope from the dropdown.

![Scope dropdown with Jira-test-scope selected](/files/F5xsopqqB1d355V2tqh5)

Type your request and click **Create Ticket**.

![Ticket ready with Jira scope](/files/acDfqXmEbb8L4MZJSohz)

***

## Step 5 — Output

The agent authenticates with your Jira instance and executes the request. Results appear in the ticket thread.

![Agent reading and acting on Jira tickets](/files/2r0zmfwbsipYZ53duEUb)

![Both tickets transitioned to Done](/files/Efea6pB3BWCYwc8JjApz)


---

# 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.duplocloud.com/docs/getting-started/integrating-providers/jira.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.