Skip to main content

​
Before you begin

Make sure you have:

​
Connect your Confluence account

1

Open Integrations

Go to Potpie → Integrations.
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
​
tool
Lists all Confluence spaces accessible to the connected account.
​
tool
Lists pages within a specific space. Use this to browse available content before reading or updating a 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.
​
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
​
tool
Creates a new page in a specified space. Requires a title, body content, and a valid space key.
​
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.
​
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.