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

# Confluence

> Search and manage pages and spaces in Confluence — create documentation, search content, and keep your knowledge base in sync from Mantle

Connect Confluence to let selected agents create and edit pages, search content, manage spaces, and work with the
documentation available to your connected account.

***

## What you unlock

<CardGroup cols={2}>
  <Card title="Page management" icon="file-lines">
    Create, edit, and organize pages and blog posts directly from chat or through an agent.
  </Card>

  <Card title="Content search" icon="magnifying-glass">
    Search the Confluence content your connected account can access by using a structured query or natural language.
  </Card>

  <Card title="Space management" icon="folder-open">
    Browse spaces, manage properties and permissions, and organize your knowledge base.
  </Card>

  <Card title="Comments & labels" icon="tags">
    Add comments, manage labels, and collaborate on content without switching to Confluence.
  </Card>
</CardGroup>

***

## Connect Confluence

<Steps>
  <Step title="Open Settings → Integrations">
    In any workspace go to **Settings → Integrations** and select **Confluence**.
  </Step>

  <Step title="Authorize with OAuth">
    Click **Connect** and sign in to your Atlassian account. Grant Mantle the requested permissions to access your
    Confluence data.
  </Step>

  <Step title="Confirm the connection">
    Once authorized, you'll be redirected back to Mantle. The integration status will show as connected.
  </Step>
</Steps>

***

## Agent tools

Add Confluence tools to agents that need them. Their access is limited by the connected account and selected tools.

### Pages

| Tool            | Description                              |
| --------------- | ---------------------------------------- |
| Create page     | Create a new page in a space             |
| Get page        | Retrieve page content and metadata by ID |
| Update page     | Edit an existing page's title or body    |
| Get child pages | List child pages under a parent page     |
| Get page labels | Retrieve labels attached to a page       |
| Delete page     | Remove a page from a space               |

### Blog Posts

| Tool             | Description                             |
| ---------------- | --------------------------------------- |
| Create blog post | Publish a new blog post in a space      |
| Get blog post    | Retrieve blog post content and metadata |
| Update blog post | Edit an existing blog post              |
| List blog posts  | List blog posts with optional filters   |

### Spaces & Search

| Tool           | Description                                     |
| -------------- | ----------------------------------------------- |
| Create space   | Create a new space in Confluence                |
| Get space      | Retrieve space details and configuration        |
| List spaces    | List all spaces you have access to              |
| Search content | Search pages, blog posts, and attachments       |
| CQL search     | Run advanced Confluence Query Language searches |

### Comments & Tasks

| Tool                | Description                                   |
| ------------------- | --------------------------------------------- |
| Create comment      | Add a footer comment to a page                |
| Get inline comments | Retrieve inline comments on a page            |
| Get tasks           | List tasks across pages                       |
| Update task         | Mark a task as complete or update its details |

***

## Triggers

<Note>
  Automated triggers for Confluence are not yet available. Triggers will be added in a future update — check back soon.
</Note>

***

## Example use cases

<AccordionGroup>
  <Accordion title="Generate a meeting notes page from chat">
    After a meeting discussion in chat, ask your agent to create a Confluence page with a summary, action items, and
    decisions — organized under the right space and parent page.
  </Accordion>

  <Accordion title="Search documentation during conversations">
    When a question comes up in chat, your agent can search Confluence for relevant pages and surface the answer inline
    — no tab-switching needed.
  </Accordion>

  <Accordion title="Keep a runbook up to date">
    An agent monitors chat for incident resolution steps and appends them to the team's runbook page in Confluence,
    keeping your operational docs current.
  </Accordion>
</AccordionGroup>

***

## Troubleshooting

<AccordionGroup>
  <Accordion title="OAuth connection failed">
    Make sure you are signing in with an Atlassian account that has access to the Confluence instance you want to
    connect. Try disconnecting and reconnecting from **Settings → Integrations → Confluence**.
  </Accordion>

  <Accordion title="Agent can't find my space">
    The connected account must have permission to view the space. Check your Confluence space permissions and ensure the
    authenticating user has at least read access.
  </Accordion>

  <Accordion title="Page creation fails">
    Verify the target space exists and the connected user has create permissions. Also check that the page title doesn't
    already exist in the same space if duplicates are restricted.
  </Accordion>

  <Accordion title="CQL search returns unexpected results">
    CQL syntax differs from Jira's JQL. Use the agent to help construct queries — it can translate requests like "find
    pages about onboarding updated this week" into valid CQL.
  </Accordion>
</AccordionGroup>

***

<Card title="Back to Integrations" icon="plug" href="/integrations/overview">
  View all available integrations
</Card>