Before you begin
Make sure you have:- A Potpie account
- A Confluence Cloud account with permission to authorize OAuth applications on your Atlassian organization
Connect your Confluence account
Open Integrations
Go to Potpie → Integrations.
Once connected, agents can use Confluence tools whenever they are included in the agent’s tool list.
What agents can do with Confluence
Each tool below becomes available to any agent that has it included in its tool list. All tools require an active Confluence connection — if none is found, the tool returns an error prompting you to connect Confluence first. Reading and searching pagesLists all Confluence spaces accessible to the connected account.
Lists pages within a specific space. Use this to browse available content before reading or updating a page.
Reads the full content of a page, including its body and current version number. Always call this before updating a page — Confluence requires the correct incremented version in update requests.
Searches pages using CQL (Confluence Query Language) with full-text search across spaces. Use this to find relevant documentation by keyword, label, or space.
Creates a new page in a specified space. Requires a title, body content, and a valid space key.
Updates a page’s title or body. You must call
get_confluence_page first to obtain the current version number — Confluence rejects updates that do not include the correct incremented version.Posts a footer comment or a threaded reply to an existing page.

