Skip to main content

Before you begin

Make sure you have:

Connect your Confluence account

1

Open Integrations

Go to PotpieIntegrations.
2

Authorize Confluence

Click Connect Confluence and complete the OAuth consent screen on Atlassian’s side. Potpie stores your access and refresh tokens encrypted in PostgreSQL, linked to your Confluence Cloud site.
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 pages
get_confluence_spaces
tool
Lists all Confluence spaces accessible to the connected account.
get_confluence_space_pages
tool
Lists pages within a specific space. Use this to browse available content before reading or updating a page.
get_confluence_page
tool
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.
search_confluence_pages
tool
Searches pages using CQL (Confluence Query Language) with full-text search across spaces. Use this to find relevant documentation by keyword, label, or space.
Creating and updating pages
create_confluence_page
tool
Creates a new page in a specified space. Requires a title, body content, and a valid space key.
update_confluence_page
tool
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.
add_confluence_comment
tool
Posts a footer comment or a threaded reply to an existing page.

Token refresh

Potpie automatically refreshes your Confluence access token before it expires. No action is required from you — agents will continue working without interruption across token cycles.