skills.rest
pgoell
pgoellCOMMUNITY
Explore all skills by this author →
Website𝕏@pagoellGitHub

confluence

Search, read, create, and update Confluence pages via REST API and acli.

Updated Mar 18, 2026
Search Tags:#documentation#rest api#atlassian#wiki#cql#confluence#curl
One-click install
npx skills add https://github.com/pgoell/pgoell-claude-tools --skill confluence-pgoell
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: confluence
Source: https://github.com/pgoell/pgoell-claude-tools/tree/main/plugins/atlassian/skills/confluence
Command: npx skills add https://github.com/pgoell/pgoell-claude-tools --skill confluence-pgoell

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Working with Confluence Cloud programmatically requires navigating two different REST API versions, CQL query syntax, and the XHTML storage format, which is error-prone and time-consuming to do manually. ## Core Features & Use Cases - CQL Search: Find pages by title, space, creator, labels, dates, or full-text content using the v1 search API. - Page Management: Read pages with body content, create new pages, update existing pages with proper version handling, and add comments via the v2 API. - Space Browsing: List and view Confluence spaces using curl or the acli CLI fallback. - Use Case: Ask to "update the architecture page in the ENG space with our new deployment diagram notes" and the skill searches for the page, reads the current version, constructs storage-format XHTML, and updates it with the correct version increment. ## Quick Start Ask the assistant to find the onboarding documentation page in Confluence and summarize its contents.

Frequently Asked Questions about confluence

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I search Confluence pages with CQL?▼

CQL search uses the v1 REST API endpoint /wiki/rest/api/search with a cql query parameter, for example type = page AND title ~ "onboarding". The v2 API does not support CQL, so all searches must go through v1.

How do I update a Confluence page via the REST API?▼

First GET the page from the v2 API to read its current version number, then PUT the updated content with version.number incremented by one. Skipping the GET causes a 409 conflict error because Confluence enforces optimistic versioning.

What format does the Confluence API use for page content?▼

Confluence uses an XHTML-based storage format for page bodies, not Markdown or plain HTML. Elements like code blocks, info panels, and task lists use ac:structured-macro XML elements, and the body-format=storage parameter is required to retrieve page content.

Can acli create or update Confluence pages?▼

No, acli only supports page view by ID and space list/view operations for Confluence. All write operations including page creation, updates, and comments require direct curl calls to the v2 REST API.

Why does my Confluence API call return a 401 or 403 error?▼

Auth errors mean the ATLASSIAN_DOMAIN, ATLASSIAN_EMAIL, or ATLASSIAN_API_TOKEN environment variables are missing or invalid. Verify each variable is set without printing its value, and generate a new API token at id.atlassian.com if needed.

Related Skills

Explore More Software Engineering Skills→
NCLGISANCLGISA

confluence

Manage Confluence Cloud pages, spaces, blog posts, comments, labels, and tasks via REST API v2.

Official
Advanced
esneiderbravoesneiderbravo
1

spec-to-backlog

Convert Confluence specification documents into structured Jira backlogs with Epics and child tickets.

Community
Advanced
Design-System-ETDesign-System-ET

atlassian-mcp

Integrate Atlassian Jira and Confluence via the Model Context Protocol.

Official
Advanced
son-nguyen-301son-nguyen-301

write-confluence

Convert Markdown to Confluence storage format and publish or update pages.

Community
Advanced