Confluence
Confluence API integration for pages, spaces, search, and comments
The Confluence integration lets your agents manage pages, spaces, search content, and work with comments and labels.
Prerequisites
You need:
- Atlassian Cloud ID — Find it by navigating to
https://your-domain.atlassian.net/_edge/tenant_info. - One of the following for authentication:
- Email + API Token (Confluence Cloud) — Generate an API token at Atlassian Account → Security → API tokens.
- Personal Access Token (Confluence Server/Data Center) — Generate in your Confluence profile settings.
- OAuth — For user-level access where each chat user authorizes with their own Confluence account.
Setup
- Open Integrations from the sidebar
- Select Confluence from the catalog
- Click Add Integration Config
- Give the config a display name (e.g., "Confluence - Engineering Wiki")
- Enter your Cloud ID in the configuration parameters
- Choose your authentication method:
- Basic Auth — Enter your Atlassian email and API token
- Personal Access Token — Paste your PAT
- OAuth — Click Connect to start the Confluence OAuth flow
- Save the config
Using in Your Agent
- Open your agent in Agent Studio and select an Agent Step
- Under Attached Integration Configurations, click Attach configuration and choose your config
- Attach Confluence tools from the tools panel
- Tools are referenced as
confluence.search_content,confluence.create_page, etc.
Available Tools
| Tool | Description | Action Type |
|---|---|---|
list_pages | List pages in a Confluence space | ReadOnly |
get_page | Get a single Confluence page by ID | ReadOnly |
create_page | Create a new page in a Confluence space | Reversible |
update_page | Update an existing Confluence page | Reversible |
delete_page | Delete a Confluence page | Irreversible |
list_spaces | List all Confluence spaces the user has access to | ReadOnly |
get_space | Get details of a specific Confluence space | ReadOnly |
search_content | Search Confluence content using CQL | ReadOnly |
get_page_comments | Get footer comments on a Confluence page | ReadOnly |
add_page_comment | Add a footer comment to a Confluence page | Irreversible |
get_page_labels | Get all labels on a Confluence page | ReadOnly |
add_page_label | Add a label to a Confluence page | Reversible |