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 your agent in Agent Studio
- In the Integrations panel, click Add Integration Config
- Select Confluence from the integration list
- 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 agent revision
Using in Your Agent
- In an Agent Step, attach Confluence tools from the tools panel
- The agent uses your integration config for all Confluence API calls
- 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 |