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

# 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

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

## Connect to Adapt

**1. Open Integrations**

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

**2. Find Confluence**

Search for **Confluence** 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 |
| - | - |
| `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.

**5. Test the connection**

Ask Adapt to list your spaces.

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


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