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

# Confluence

> Connect Confluence to your Atako agents — 9 read and 3 write actions.

Let your agents search, read, create and update Confluence pages and comments, list spaces and labels, and browse attachments.

## Connection

* **Authentication**: API key (Atlassian email and API token (email:token)).
* **Required settings**:
  * **Site name** — yourcompany in yourcompany.atlassian.net

<Note>
  Go to id.atlassian.com → Security → API tokens ([https://id.atlassian.com/manage-profile/security/api-tokens](https://id.atlassian.com/manage-profile/security/api-tokens)) → Create API token → name it and copy it. The token inherits your Confluence permissions — an account with read access to spaces and pages is enough. Enter the credential as [your-email@company.com](mailto:your-email@company.com):the\_api\_token (email and token joined by a colon).

  See [Confluence's documentation](https://id.atlassian.com/manage-profile/security/api-tokens).
</Note>

## Read actions (9)

| Action | Description |
| - | - |
| `get_page` | Fetch a single page by id, with body in storage format. |
| `get_space` | Fetch a single space by id. |
| `list_page_attachments` | List the attachments on a page (paginated). No binary download. |
| `list_page_children` | List the direct children of a page (paginated). |
| `list_page_comments` | List footer comments for a page (paginated). |
| `list_page_labels` | List the labels on a page (paginated). |
| `list_pages` | List pages (paginated). Optional spaceId (the numeric space id from list\_spaces, passed as a STRING, e.g. "98306") restricts to one space. |
| `list_spaces` | List spaces visible to the authenticated user (paginated). |
| `search` | Search Confluence content using CQL (Confluence Query Language). The cql parameter is required. |

## Write actions (3)

| Action | Description |
| - | - |
| `create_page` | Create a page in a space. Arguments: spaceId (string id from list\_spaces), title (string), body (a plain STRING of Confluence storage-format XHTML, e.g. "\<p>Hello\</p>" — not an object), optional parentId (string). |
| `create_page_comment` | Add a footer comment to a page. Arguments: page\_id (string), body (a plain STRING of storage-format XHTML), optional parent\_comment\_id (string) to reply to an existing comment. |
| `update_page` | Replaces title and body entirely: read the page with get\_page (body-format=storage) first, then send title (string), body (a plain STRING of storage-format XHTML) and version (a bare INTEGER equal to the current version number + 1 — not an object). |

## Permissions

Every action above must be explicitly granted to an agent before it can be used. See [Permissions](/integrations/permissions) for the grant model and [Security](/integrations/security) for how credentials are protected.

***

*Last reviewed against the provider API: September 2026.*


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