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

# Confluence Data Center Toolset

> Wiki pages and documentation management for AI agents on self-hosted Confluence

<div className="max-w-2xl mx-auto mt-12">
  <div className="p-6 border border-gray-200 dark:border-gray-700 rounded-lg bg-blue-50 dark:bg-gray-800">
    <div className="flex items-center mb-4">
      <img src="https://mintcdn.com/pipeshub/8k-iBPRh1yJZHQe1/logo/confluence.png?fit=max&auto=format&n=8k-iBPRh1yJZHQe1&q=85&s=90d0e7fb5418167b553db5c420a8c72f" alt="Confluence Logo" className="w-8 h-8 mr-3 object-contain flex-shrink-0" width="567" height="545" data-path="logo/confluence.png" />

      <h2 className="text-2xl font-semibold m-0">Confluence Data Center Toolset</h2>
    </div>

    <p className="text-lg text-gray-700 dark:text-gray-300 mb-4">Wiki pages and documentation on self-hosted Confluence</p>

    <div className="flex items-center gap-2">
      <span className="px-3 py-1 bg-green-100 dark:bg-green-900 text-green-800 dark:text-green-200 rounded-full text-sm font-medium">
        Ready
      </span>

      <span className="px-3 py-1 bg-purple-100 dark:bg-purple-900 text-purple-800 dark:text-purple-200 rounded-full text-sm font-medium">
        Atlassian
      </span>
    </div>
  </div>
</div>

## Overview

The Confluence Data Center toolset lets AI agents work with the Confluence you run on your own servers. Agents can create pages, update content, search documentation, read spaces, and add comments. Use it to automate documentation work and to make your knowledge base reachable through a conversation with an agent.

<Info>
  If Atlassian hosts your Confluence for you, that is Confluence Cloud. Use the [Confluence Cloud toolset](/toolsets/confluence/confluence) instead. The two toolsets are not interchangeable.
</Info>

### Key Capabilities

* **Create and update pages** - Write new documentation, change existing pages, move pages under a new parent
* **Search content** - Search page titles, or search the full text of your content
* **Space operations** - List spaces, read space details
* **Page hierarchy** - Browse child pages and version history
* **Comments** - Add comments and replies, and read existing ones
* **User operations** - Search users, get the current user

***

## Available Tools

| Tool                  | Description                                                     |
| --------------------- | --------------------------------------------------------------- |
| `create_page`         | Create a new page in a space                                    |
| `update_page`         | Change a page's title or content, or move it under a new parent |
| `get_page_content`    | Get the content of a page                                       |
| `get_pages_in_space`  | Get the pages in a space                                        |
| `get_child_pages`     | Get the pages directly under a page                             |
| `get_page_versions`   | Get a page's version history                                    |
| `search_pages`        | Search pages by title                                           |
| `search_content`      | Search the full text of your content                            |
| `get_spaces`          | Get all spaces you can see                                      |
| `get_space`           | Get details of a specific space                                 |
| `add_comment`         | Add a comment to a page, or reply to a comment                  |
| `get_comments`        | Get the comments on a page                                      |
| `search_users`        | Search users by name, username, or user key                     |
| `get_current_user`    | Get the signed-in user's details                                |
| `validate_connection` | Check the Confluence connection                                 |

***

## Configuration Guide

The Confluence Data Center toolset supports **two ways to sign in**: Personal Access Token (PAT) and Basic Authentication.

In both cases the work is split between an admin and each user:

* **The admin** sets up the shared instance under **Workspace Settings → Actions** and enters only the **Base URL**.
* **Each user** then opens **Your actions** and enters their own credentials.

Every user who wants to use the toolset needs their own credentials, because each agent action runs as that user in Confluence.

<Warning>
  **This toolset supports Personal Access Token and Basic Authentication only.** OAuth apps you create in the Atlassian Developer Console are for Confluence Cloud and will not work here.
</Warning>

| Method                          | Best for                                                                                                                                   |
| ------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------ |
| **Personal Access Token (PAT)** | Recommended. Needs Confluence 7.9 or later. Each user creates their own token and can revoke it at any time.                               |
| **Basic Authentication**        | Older instances that do not support tokens, or where an admin has turned token creation off. Each user enters their username and password. |

<Tabs>
  <Tab title="Personal Access Token">
    #### Step 1: Each user creates a Personal Access Token

    Every user who will use the toolset needs their own token.

    1. Sign in to your Confluence.
    2. Click your **profile picture** in the top right, then select **Settings**.
    3. Open the **Personal Access Tokens** tab and click **Create token**.
    4. Give it a name you will recognise, such as `PipesHub Confluence Toolset`, set an expiry if you want, then click **Create**.

    <div className="text-center">
      <img src="https://mintcdn.com/pipeshub/uuLTAPtR53lSTg2o/images/toolsets/confluence-data-center/pat_create_token.png?fit=max&auto=format&n=uuLTAPtR53lSTg2o&q=85&s=e4f0d9af85127caeead338b07ba115f1" alt="Create a Personal Access Token in Confluence Data Center" className="block mx-auto w-11/12" width="1902" height="986" data-path="images/toolsets/confluence-data-center/pat_create_token.png" />
    </div>

    5. Confluence shows the token **once**. Copy it and store it somewhere safe.

    <div className="text-center">
      <img src="https://mintcdn.com/pipeshub/uuLTAPtR53lSTg2o/images/toolsets/confluence-data-center/pat_copy_token.png?fit=max&auto=format&n=uuLTAPtR53lSTg2o&q=85&s=ca675e8541824b1a682a51af83def4c3" alt="Copy the Personal Access Token — shown once" className="block mx-auto w-11/12" width="1902" height="860" data-path="images/toolsets/confluence-data-center/pat_copy_token.png" />
    </div>

    <Warning>
      The token is shown only once. If you close the dialog before copying it, revoke it and create a new one.
    </Warning>

    <Info>
      A token has the same access as the person who created it. An agent using your token can only do what you can do in Confluence.
    </Info>

    #### Step 2: Admin — create the instance in Actions

    The admin sets only the Base URL here. No credentials are entered at this step.

    1. In PipesHub, go to **Workspace Settings** → **Actions**.
    2. Find **Confluence Data Center** and click **+ Setup** for a new instance.
    3. Choose **Personal Access Token** as the sign-in method, then enter:
       * **Instance Name** (e.g., `Confluence Production`)
       * **Base URL** — the root URL of your Confluence, such as `https://confluence.yourcompany.com`, with no trailing slash
    4. Click **Create**.

    <div className="text-center">
      <img src="https://mintcdn.com/pipeshub/uuLTAPtR53lSTg2o/images/toolsets/confluence-data-center/actions_admin_setup.png?fit=max&auto=format&n=uuLTAPtR53lSTg2o&q=85&s=eb572dbee91b8a654d3dde7837b45b7b" alt="Admin Actions dialog — Instance Name and Base URL only" className="block mx-auto w-11/12" width="1905" height="940" data-path="images/toolsets/confluence-data-center/actions_admin_setup.png" />
    </div>

    <Info>
      Opening the instance settings later brings this dialog back, where you can change the **Instance Name** and **Base URL**. A button below it opens **Your actions** so each user can add their own credentials.
    </Info>

    #### Step 3: Each user — add their token in Your actions

    Every user who wants to use the toolset does this with their own token.

    1. In PipesHub, open **Your actions** (under **Personal** in the sidebar).
    2. Find the Confluence Data Center instance and open it.
    3. Enter your **Personal Access Token** from Step 1.
    4. Click **Save credentials**.

    <div className="text-center">
      <img src="https://mintcdn.com/pipeshub/uuLTAPtR53lSTg2o/images/toolsets/confluence-data-center/your_actions_credentials.png?fit=max&auto=format&n=uuLTAPtR53lSTg2o&q=85&s=f4920c02d0b479e844ea3d4af3985f4a" alt="Your actions — enter your Personal Access Token" className="block mx-auto w-11/12" width="1912" height="936" data-path="images/toolsets/confluence-data-center/your_actions_credentials.png" />
    </div>

    The tile in **Your actions** now shows **Authenticated**. The toolset is connected for you only. Every other user has to repeat this step with their own token.

    #### Step 4: Add the toolset to an agent

    1. Go to the **Home** page.
    2. Next to **Agents**, click **+** to create a new agent.
    3. Name the agent, drag the **Confluence Data Center** toolset onto the canvas, connect it to the **Agent Core** node along with your model and chat input and output, then create the agent.

    <div className="text-center">
      <img src="https://mintcdn.com/pipeshub/uuLTAPtR53lSTg2o/images/toolsets/confluence-data-center/create_agent.png?fit=max&auto=format&n=uuLTAPtR53lSTg2o&q=85&s=470500672d0649d34b928cf820f8351f" alt="Agent builder with the Confluence Data Center toolset connected" className="block mx-auto w-11/12" width="1917" height="943" data-path="images/toolsets/confluence-data-center/create_agent.png" />
    </div>
  </Tab>

  <Tab title="Basic Authentication">
    Use this on instances that do not support Personal Access Tokens, or where an admin has turned off token creation.

    #### Step 1: Admin — create the instance in Actions

    The admin sets only the Base URL here. No credentials are entered at this step.

    1. In PipesHub, go to **Workspace Settings** → **Actions**.
    2. Find **Confluence Data Center** and click **+ Setup** for a new instance.
    3. Choose **Basic Authentication** as the sign-in method, then enter:
       * **Instance Name** (e.g., `Confluence Production`)
       * **Base URL** — the root URL of your Confluence, such as `https://confluence.yourcompany.com`, with no trailing slash
    4. Click **Create**.

    <div className="text-center">
      <img src="https://mintcdn.com/pipeshub/uuLTAPtR53lSTg2o/images/toolsets/confluence-data-center/actions_admin_setup_basic_auth.png?fit=max&auto=format&n=uuLTAPtR53lSTg2o&q=85&s=4f1ecba4d6eef5d2b816817861e8932f" alt="Admin Actions dialog with Basic Authentication — Instance Name and Base URL only" className="block mx-auto w-11/12" width="1911" height="937" data-path="images/toolsets/confluence-data-center/actions_admin_setup_basic_auth.png" />
    </div>

    #### Step 2: Each user — add their username and password in Your actions

    Every user who wants to use the toolset does this with their own account.

    1. In PipesHub, open **Your actions** (under **Personal** in the sidebar).
    2. Find the Confluence Data Center instance and open it.
    3. Enter:
       * **Username** — your Confluence username
       * **Password** — your Confluence password
    4. Click **Save credentials**.

    <div className="text-center">
      <img src="https://mintcdn.com/pipeshub/uuLTAPtR53lSTg2o/images/toolsets/confluence-data-center/your_actions_credentials_basic_auth.png?fit=max&auto=format&n=uuLTAPtR53lSTg2o&q=85&s=b817df75fcd465bb8f3de22f56a9acd9" alt="Your actions — enter your username and password" className="block mx-auto w-11/12" width="1912" height="941" data-path="images/toolsets/confluence-data-center/your_actions_credentials_basic_auth.png" />
    </div>

    <Warning>
      Enter the Confluence **username**, not the email address. On many instances these are different.
    </Warning>

    #### Step 3: Add the toolset to an agent

    1. Go to the **Home** page.
    2. Next to **Agents**, click **+** to create a new agent.
    3. Name the agent, drag the **Confluence Data Center** toolset onto the canvas, connect it to the **Agent Core** node along with your model and chat input and output, then create the agent.

    <div className="text-center">
      <img src="https://mintcdn.com/pipeshub/uuLTAPtR53lSTg2o/images/toolsets/confluence-data-center/create_agent.png?fit=max&auto=format&n=uuLTAPtR53lSTg2o&q=85&s=470500672d0649d34b928cf820f8351f" alt="Agent builder with the Confluence Data Center toolset connected" className="block mx-auto w-11/12" width="1917" height="943" data-path="images/toolsets/confluence-data-center/create_agent.png" />
    </div>
  </Tab>
</Tabs>

***

## FAQ

<AccordionGroup>
  <Accordion title="Can I use OAuth with the Confluence Data Center toolset?">
    No. This toolset supports **Personal Access Token** and **Basic Authentication** only. OAuth apps created in the Atlassian Developer Console are for Confluence Cloud and will not work here.
  </Accordion>

  <Accordion title="Should I use a Personal Access Token or Basic Authentication?">
    |                      | Personal Access Token      | Basic Authentication                            |
    | -------------------- | -------------------------- | ----------------------------------------------- |
    | **Best for**         | Confluence 7.9 or later    | Older instances, or where tokens are turned off |
    | **Admin sets up**    | Instance Name and Base URL | Instance Name and Base URL                      |
    | **Each user enters** | Their own token            | Their username and password                     |

    Use a **Personal Access Token** unless your instance cannot create them.
  </Accordion>

  <Accordion title="What is the difference between the Confluence Data Center connector and toolset?">
    | Aspect        | Connector                                           | Toolset                                    |
    | ------------- | --------------------------------------------------- | ------------------------------------------ |
    | **Purpose**   | Sync and index Confluence data so you can search it | Let agents do things in Confluence         |
    | **Direction** | One way, Confluence into PipesHub                   | Two ways, read and write                   |
    | **Use it to** | Search pages, spaces, and blog posts                | Create pages, update content, add comments |

    **Example:** use the [connector](/connectors/confluence/confluence-data-center) to search your documentation. Use the toolset to let an agent write or update a page.
  </Accordion>

  <Accordion title="Why do I have to enter my own credentials?">
    Every agent action runs as a real Confluence user. Using your own token means agents can only see and change what you can see and change in Confluence, and the page history in Confluence shows who did it.
  </Accordion>
</AccordionGroup>

***

## Usage Tips

**How do I create a page?**\
Ask your agent to "create a Confluence page" and give it the space, the title, and what the page should say. To nest the new page under an existing one, mention the parent page.

**Which space name do I give it?**\
Data Center uses the space **key**, such as `ENG` or `DS`. A personal space key starts with a tilde, such as `~jdoe`. You can find the key in the space URL. If you are not sure, ask the agent to list your spaces first.

**How do I update a page?**\
Ask to change the title, the content, or both. You can also ask to move a page under a different parent. Anything you do not mention stays as it is.

**How do I search?**\
Ask to "find Confluence pages about X". The agent searches page titles when you are looking for a specific page, and searches the full text of your content when you are looking for a topic.

**How do I comment on a page?**\
Ask the agent to add a comment to a page. To continue a thread rather than start a new one, tell it which comment to reply to.

**What formatting can I use in page content?**\
Confluence storage format, which is XHTML. Plain text works too and is wrapped for you.