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

# Jira

> Connect Jira Cloud to Adapt to analyze issues, sprints, projects, and workflows

Connect your Atlassian Jira Cloud account to Adapt using an API token with Basic authentication.

## Set up credentials

**1. Open the Atlassian API token page**

Sign in to your Atlassian account, then go to [https://id.atlassian.com/manage-profile/security/api-tokens](https://id.atlassian.com/manage-profile/security/api-tokens).

**2. Create an API token**

Click **Create API token**, give it a descriptive name, set an expiration date, then click **Create**.

**3. Copy the token**

Click **Copy to clipboard** and store the token somewhere safe. Atlassian shows it only once.

**4. Note your email and site domain**

Record the email address of your Atlassian account and your Jira site domain, for example `your-company.atlassian.net`.

> [!NOTE]
>
> Jira authenticates with HTTP Basic auth using your account email as the username and the API token as the password.

## Connect to Adapt

**1. Open Integrations**

In Adapt, go to **Settings > Integrations**.

**2. Find Jira**

Search for **Jira** and select it from the catalog.

**3. Start the connection**

Click **Connect** to open the connection form.

**4. Add your credentials**

Enter the values you gathered above, then click **Add connection**:

| Secret Name | Value |
| - | - |
| `JIRA_API_TOKEN` | Your Atlassian API token |
| `JIRA_EMAIL` | The email of your Atlassian account |
| `JIRA_DOMAIN` | Your Jira site domain, e.g. your-company.atlassian.net |

You can rename the connection and choose whether it is shared with your
organization or kept personal to you.

**5. Test the connection**

Ask Adapt to list your projects.

### Security

* Credentials are encrypted at rest with AES-256
* The token inherits your Jira permissions, so it can access only the projects and issues you can see
* Set an expiration date and revoke tokens anytime from your Atlassian account API token page
* Do not share or commit your API token

## Capabilities

Adapt can read your Jira Cloud site to analyze issues, sprints, projects, and workflows. Use it to track progress, surface blockers, and review team throughput.

### Examples

```
Summarize open issues in the PLATFORM project by status.
```

```
What is in the current sprint and who owns each issue?
```

```
List all high-priority bugs assigned to me.
```

```
Show how issues are moving through the workflow this week.
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.