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

# Jira

> Connect Jira for issue tracking and project context during investigations.

Connecting Jira allows Traversal to access issues and projects, enabling correlation of incidents with engineering work.

## What Traversal reads

* **Issues** — issue details, status, priority, and assignee via JQL search
* **Comments** — full comment threads on issues

## Setup

<Steps>
  <Step title="Create an API token">
    1. Open [Atlassian API tokens](https://id.atlassian.com/manage-profile/security/api-tokens) and sign in
    2. Create an API token for Jira, give it a descriptive name, and choose an expiration date
    3. If Atlassian shows a scoped-token flow in your organization, select the Jira app and grant read-only access. `read:jira-work` covers the Jira endpoints Traversal uses to read issues, comments, JQL search results, and attachments
    4. Copy the generated token right away. Atlassian only shows it once
  </Step>

  <Step title="Configure in Traversal">
    Go to **Company Knowledge > Integrations**, select Jira, and enter:

    * Jira instance URL (usually your site URL, such as `https://company.atlassian.net`)
    * Email address associated with your Atlassian account
    * API token
    * Cloud ID, only if your Jira URL uses Atlassian's API gateway instead of your site URL
  </Step>
</Steps>

### Jira URL and Cloud ID

Use your Jira site URL, such as `https://company.atlassian.net`, whenever possible.

If your organization routes Jira API traffic through Atlassian's API gateway instead of your site URL, also provide the site's **Cloud ID**. Atlassian's current docs refer to this as `cloudId` in gateway URLs such as `.../ex/jira/{cloudId}/...`, and Traversal exposes a separate `Cloud ID` field for those setups.

## More information

* [Atlassian API tokens](https://support.atlassian.com/atlassian-account/docs/manage-api-tokens-for-your-atlassian-account/)
* [Jira scopes for Atlassian scoped tokens](https://developer.atlassian.com/cloud/jira/platform/scopes-for-oauth-2-3LO-and-forge-apps/)
* [Atlassian API gateway and Cloud ID](https://developer.atlassian.com/cloud/oauth/getting-started/making-calls-to-api/)
* [Find your Atlassian Cloud ID](https://support.atlassian.com/jira/kb/retrieve-my-atlassian-sites-cloud-id/)