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