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

# Confluence

> Connect Confluence to surface runbooks and documentation during investigations.

Connecting Confluence allows Traversal to surface runbooks, procedures, and postmortems during investigations and cite relevant internal documentation as evidence.

## What Traversal reads

* **Pages** — page content searched via CQL and fetched by ID
* **Spaces** — space metadata used to scope searches

## Required scopes

When issuing a scoped Atlassian API token, grant the following minimum Confluence scopes for optimal agent performance:

| Scope                        | Used for                                                                                |
| ---------------------------- | --------------------------------------------------------------------------------------- |
| `search:confluence`          | CQL search across pages — required for the agent to discover relevant runbooks and docs |
| `read:page:confluence`       | Fetching full page content by ID after a search hit                                     |
| `read:space:confluence`      | Resolving space metadata used to scope searches and label results                       |
| `read:attachment:confluence` | Reading attachments referenced from pages                                               |

<Info>
  Only `search:confluence` is needed for the connection health check on the Traversal UI to pass.
</Info>

## Setup

<Tabs>
  <Tab title="Atlassian Cloud">
    <Steps>
      <Step title="Create an Atlassian API token">
        1. Open [Atlassian API tokens](https://id.atlassian.com/manage-profile/security/api-tokens) and sign in
        2. Create a standard Atlassian API token, give it a descriptive name, and choose an expiration date
        3. Copy the generated token right away. Atlassian only shows it once
      </Step>

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

        * Confluence site URL (usually `https://company.atlassian.net/wiki`)
        * Your Atlassian account email
        * API token
      </Step>
    </Steps>
  </Tab>

  <Tab title="Self-hosted (Server or Data Center)">
    <Steps>
      <Step title="Create a personal access token">
        1. In Confluence, select your avatar, then go to **Settings > Personal access tokens**
        2. Create a token, optionally set an expiration date, and copy it right away
      </Step>

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

        * Confluence site URL
        * Personal access token
      </Step>
    </Steps>
  </Tab>
</Tabs>

<Info>
  Traversal exposes two Confluence authentication modes:

  * **Basic Authentication** for Atlassian Cloud
  * **Bearer Token** for self-hosted Confluence Server or Data Center
</Info>

## More information

* [Atlassian API tokens](https://support.atlassian.com/atlassian-account/docs/manage-api-tokens-for-your-atlassian-account/)
* [Confluence Data Center personal access tokens](https://confluence.atlassian.com/display/ENTERPRISE/Using+personal+access+tokens)