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

# Confluence Toolkit

> Interact with Confluence spaces, pages, and content from within a workflow.

The **Confluence Toolkit** allows your workflows to interact with Confluence — retrieving spaces, pages, and content, as well as creating, searching, and deleting pages.

## Authentication

All Confluence tools require a Confluence account connection. Each tool includes a **Confluence Account** selector with two options:

| Option                        | Description                                                       |
| ----------------------------- | ----------------------------------------------------------------- |
| **Use my Confluence account** | Uses your personal connected Confluence account.                  |
| **Use team account**          | Uses a shared team Confluence account configured for the project. |

If no account is connected, click **Connect Confluence Account** to authenticate.

## Tools

### Get Confluence Sites

Retrieves all Confluence sites accessible to the connected account.

| Field                  | Required | Description                                      |
| ---------------------- | -------- | ------------------------------------------------ |
| **Confluence Account** | Yes      | Select your personal or team Confluence account. |

### Get Confluence Spaces

Retrieves spaces accessible to the connected Confluence account.

| Field                  | Required | Description                                                     |
| ---------------------- | -------- | --------------------------------------------------------------- |
| **Confluence Account** | Yes      | Select your personal or team Confluence account.                |
| **Limit**              | No       | Maximum number of spaces to return. Default is `50`.            |
| **Type**               | No       | Filter by space type (`personal`, `global`). Default is `null`. |

### Get Confluence Pages

Retrieves pages from a Confluence space with optional filters for status and pagination.

| Field                  | Required | Description                                                                               |
| ---------------------- | -------- | ----------------------------------------------------------------------------------------- |
| **Confluence Account** | Yes      | Select your personal or team Confluence account.                                          |
| **Space Key**          | No       | The key of the space to get pages from. Type `@` to select a variable. Default is `null`. |
| **Limit**              | No       | Maximum number of pages to return. Default is `50`.                                       |
| **Status**             | No       | Filter by page status (`current`, `draft`, `archived`). Default is `null`.                |

### Get Confluence Page Content

Retrieves the content of a specific Confluence page.

| Field                  | Required | Description                                                                                |
| ---------------------- | -------- | ------------------------------------------------------------------------------------------ |
| **Confluence Account** | Yes      | Select your personal or team Confluence account.                                           |
| **Page Id**            | Yes      | The ID of the page to get content for. Type `@` to select a variable.                      |
| **Format**             | No       | Content format to return. Options: `storage`, `view`, `export_view`. Default is `storage`. |

### Get Confluence Page History

Retrieves the version history of a specific Confluence page.

| Field                  | Required | Description                                                           |
| ---------------------- | -------- | --------------------------------------------------------------------- |
| **Confluence Account** | Yes      | Select your personal or team Confluence account.                      |
| **Page Id**            | Yes      | The ID of the page to get history for. Type `@` to select a variable. |
| **Limit**              | No       | Maximum number of history entries to return. Default is `10`.         |

### Get Confluence Attachments

Retrieves the attachments associated with a specific Confluence page.

| Field                  | Required | Description                                                               |
| ---------------------- | -------- | ------------------------------------------------------------------------- |
| **Confluence Account** | Yes      | Select your personal or team Confluence account.                          |
| **Page Id**            | Yes      | The ID of the page to get attachments for. Type `@` to select a variable. |

### Get Confluence Comments

Retrieves comments on a specific Confluence page.

| Field                  | Required | Description                                                            |
| ---------------------- | -------- | ---------------------------------------------------------------------- |
| **Confluence Account** | Yes      | Select your personal or team Confluence account.                       |
| **Page Id**            | Yes      | The ID of the page to get comments for. Type `@` to select a variable. |
| **Limit**              | No       | Maximum number of comments to return. Default is `25`.                 |

### Search Confluence Content

Searches for content across a Confluence site using a query string.

| Field                  | Required | Description                                                                              |
| ---------------------- | -------- | ---------------------------------------------------------------------------------------- |
| **Confluence Account** | Yes      | Select your personal or team Confluence account.                                         |
| **Query**              | Yes      | The search query string. Type `@` to select a variable.                                  |
| **Space Key**          | No       | Limit the search to a specific space. Type `@` to select a variable. Default is `null`.  |
| **Content Type**       | No       | Filter by content type (`page`, `blogpost`, `comment`, `attachment`). Default is `null`. |
| **Limit**              | No       | Maximum number of results to return. Default is `25`.                                    |

### Create Confluence Page

Creates a new page in a specified Confluence space.

| Field                  | Required | Description                                                                                                      |
| ---------------------- | -------- | ---------------------------------------------------------------------------------------------------------------- |
| **Confluence Account** | Yes      | Select your personal or team Confluence account.                                                                 |
| **Space Key**          | Yes      | The key of the space where the page will be created. Type `@` to select a variable.                              |
| **Title**              | Yes      | The title of the page. Type `@` to select a variable.                                                            |
| **Content**            | Yes      | Page content in Confluence storage format or plain text. Type `@` to select a variable.                          |
| **Parent Id**          | No       | The ID of the parent page for creating child pages. Default is `null`.                                           |
| **Confirm**            | No       | Must be enabled to execute. Double-confirms that you intend to create a new Confluence page. Default is `false`. |

### Delete Confluence Page

Deletes a specific Confluence page by its ID.

| Field                  | Required | Description                                                                                                    |
| ---------------------- | -------- | -------------------------------------------------------------------------------------------------------------- |
| **Confluence Account** | Yes      | Select your personal or team Confluence account.                                                               |
| **Page Id**            | Yes      | The ID of the page to delete. Type `@` to select a variable.                                                   |
| **Confirm**            | No       | Must be enabled to execute. Double-confirms that you intend to delete the Confluence page. Default is `false`. |