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

# Confluence

> Connect Confluence Cloud to Adapt to search and read spaces, pages, and documentation

Connect your Atlassian Confluence 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 Confluence site domain, for example `your-company.atlassian.net`.

    <Note>Confluence 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 Confluence">
    Search for **Confluence** 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                                                        |
    | ---------------------- | ------------------------------------------------------------ |
    | `CONFLUENCE_API_TOKEN` | Your Atlassian API token                                     |
    | `CONFLUENCE_EMAIL`     | The email of your Atlassian account                          |
    | `CONFLUENCE_DOMAIN`    | Your Confluence 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 spaces.
  </Step>
</Steps>

### Security

* Credentials are encrypted at rest with AES-256
* The token inherits your Confluence permissions, so it can access only the spaces and pages 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 search and read your Confluence Cloud site to find spaces, pages, and documentation. Use it to locate knowledge, summarize pages, and answer questions from your docs.

### Examples

```
Find Confluence pages about our onboarding process.
```

```
Summarize the latest release notes page in the Engineering space.
```

```
List the pages in the Product space updated this month.
```

```
What does our documentation say about the deployment workflow?
```