> ## Documentation Index
> Fetch the complete documentation index at: https://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

<Steps>
  <Step title="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).
  </Step>

  <Step title="Create an API token">
    Click **Create API token**, give it a descriptive name, set an expiration date, then click **Create**.
  </Step>

  <Step title="Copy the token">
    Click **Copy to clipboard** and store the token somewhere safe. Atlassian shows it only once.
  </Step>

  <Step title="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.</Note>
  </Step>
</Steps>

## Connect to Adapt

<Steps>
  <Step title="Open Integrations">
    In Adapt, go to **Settings > Integrations**.
  </Step>

  <Step title="Find Jira">
    Search for **Jira** and select it from the catalog.
  </Step>

  <Step title="Start the connection">
    Click **Connect** to open the connection form.
  </Step>

  <Step title="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.
  </Step>

  <Step title="Test the connection">
    Ask Adapt to list your projects.
  </Step>
</Steps>

### 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.
```