confluence-page

name	confluence-page
description	Manage Confluence pages and blog posts - create, read, update, delete, copy, move, and version control. ALWAYS use when user wants to work with page content, create pages, update pages, or manage page versions.
triggers	["create page","get page","read page","update page","edit page","delete page","remove page","blog post","blogpost","create blog","copy page","duplicate page","move page","relocate page","page version","version history","restore version","revert page"]

Confluence Page Skill

Manage Confluence pages and blog posts through natural language commands.

---

⚠️ PRIMARY USE CASE

This is the core skill for all page and blog post operations. Use this skill whenever you need to:

• Create, read, update, or delete pages
• Create or manage blog posts
• Copy or move pages between spaces
• Access or restore version history

---

When to Use This Skill

Trigger	Example
Page CRUD	"Create a page", "Get page 12345", "Update the page", "Delete this page"
Blog posts	"Create a blog post", "Get blog 67890"
Copy/Move	"Copy page to ARCHIVE", "Move page under parent 12345"
Versions	"Show version history", "Restore to version 5"
Content from files	"Create page from markdown file", "Update page from content.md"

---

When NOT to Use This Skill

Operation	Use Instead
Search for pages	confluence-search
Add comments to pages	confluence-comment
Upload attachments	confluence-attachment
Add/remove labels	confluence-label
Set page restrictions	confluence-permission
View page analytics	confluence-analytics
Watch/unwatch pages	confluence-watch
Navigate page hierarchy	confluence-hierarchy

---

Risk Levels

Operation	Risk	Notes
Get page	-	Read-only
Create page	-	Easily deletable
Update page	⚠️	Creates version history, reversible
Copy page	-	Creates new page
Move page	⚠️	Can be moved back
Delete page	⚠️⚠️	Goes to trash, recoverable for 30 days
Permanent delete	⚠️⚠️⚠️	IRREVERSIBLE

---

Overview

This skill handles all CRUD operations for Confluence pages and blog posts, including:

• Creating new pages and blog posts
• Reading page content and metadata
• Updating page content, title, and status
• Deleting pages (trash or permanent)
• Copying and moving pages
• Version history and restoration

CLI Commands

confluence page create

Create a new Confluence page.

Usage:

# Create a simple page
confluence page create --space DOCS --title "My New Page" --body "Page content here"

# Create with parent page
confluence page create --space DOCS --title "Child Page" --parent 12345 --body "Content"

# Create from Markdown file
confluence page create --space DOCS --title "From Markdown" --file content.md

# Create as draft
confluence page create --space DOCS --title "Draft Page" --body "WIP" --status draft

Arguments:

• --space, -s - Space key (required)
• --title, -t - Page title (required)
• --body, -b - Page body content
• --file, -f - Read body from file (Markdown supported)
• --parent, -p - Parent page ID
• --status - Page status: current (default) or draft
• --output, -o - Output format: text or json

confluence page get

Retrieve a page's content and metadata.

Usage:

# Get by page ID
confluence page get 12345

# Get with full body content
confluence page get 12345 --body

# Get specific body format
confluence page get 12345 --body --format markdown

# JSON output
confluence page get 12345 --output json

Arguments:

• page_id - Page ID (required)
• --body - Include body content
• --format - Body format: storage (default), view, or markdown
• --output, -o - Output format: text or json

confluence page update

Update an existing page.

Usage:

# Update title
confluence page update 12345 --title "New Title"

# Update body
confluence page update 12345 --body "New content"

# Update from file
confluence page update 12345 --file updated-content.md

# Update with version message
confluence page update 12345 --body "Updated" --message "Fixed typos"

# Change status
confluence page update 12345 --status draft

Arguments:

• page_id - Page ID (required)
• --title, -t - New title
• --body, -b - New body content
• --file, -f - Read body from file
• --message, -m - Version message
• --status - New status: current or draft
• --output, -o - Output format

confluence page delete

Delete a page (move to trash or permanent delete).

Usage:

# Move to trash (default)
confluence page delete 12345

# Permanent delete
confluence page delete 12345 --permanent

# Force without confirmation
confluence page delete 12345 --force

Arguments:

• page_id - Page ID (required)
• --permanent - Permanently delete (cannot be recovered)
• --force, -f - Skip confirmation prompt

confluence page blog create

Create a new blog post.

Usage:

confluence page blog create --space BLOG --title "My Blog Post" --body "Blog content"

# From Markdown
confluence page blog create --space BLOG --title "From MD" --file post.md

Arguments:

• --space, -s - Space key (required)
• --title, -t - Blog post title (required)
• --body, -b - Blog post content
• --file, -f - Read body from file
• --output, -o - Output format

confluence page blog get

Retrieve a blog post.

Usage:

confluence page blog get 67890 --body

Arguments:

• blogpost_id - Blog post ID (required)
• --body - Include body content
• --format - Body format
• --output, -o - Output format

confluence page copy

Copy a page to a new location.

Usage:

# Copy to same space
confluence page copy 12345 --title "Page Copy"

# Copy to different space
confluence page copy 12345 --title "Page Copy" --space NEWSPACE

# Copy with children
confluence page copy 12345 --title "Page Copy" --include-children

Arguments:

• page_id - Source page ID (required)
• --title, -t - New page title (default: "Copy of [original]")
• --space, -s - Target space key
• --parent, -p - Target parent page ID
• --include-children - Copy child pages recursively
• --output, -o - Output format

confluence page move

Move a page to a new location.

Usage:

# Move to new parent
confluence page move 12345 --parent 67890

# Move to different space
confluence page move 12345 --space NEWSPACE

# Move to space root
confluence page move 12345 --space NEWSPACE --root

Arguments:

• page_id - Page ID to move (required)
• --space, -s - Target space key
• --parent, -p - Target parent page ID
• --root - Move to space root (no parent)

confluence page versions

Get version history for a page.

Usage:

# List all versions
confluence page versions 12345

# Limit results
confluence page versions 12345 --limit 10

# Show version details
confluence page versions 12345 --detailed

Arguments:

• page_id - Page ID (required)
• --limit, -l - Maximum versions to return
• --detailed - Show full version details
• --output, -o - Output format

confluence page restore

Restore a page to a previous version.

Usage:

# Restore to version 5
confluence page restore 12345 --version 5

# With version message
confluence page restore 12345 --version 5 --message "Restoring to known good state"

Arguments:

• page_id - Page ID (required)
• --version, -v - Version number to restore (required)
• --message, -m - Version message for the restoration

Examples

Natural Language Triggers

• "Create a new page called 'Meeting Notes' in the DOCS space"
• "Get the content of page 12345"
• "Update page 12345 with this content: [content]"
• "Delete the page with ID 12345"
• "Create a blog post titled 'Sprint Review' in TEAM space"
• "Copy page 12345 to the ARCHIVE space"
• "Move page 12345 under parent page 67890"
• "Show me the version history for page 12345"
• "Restore page 12345 to version 3"

Common Workflows

Create a page from natural language:

User: Create a page called "API Documentation" in DOCS space with content explaining our REST API

---

Common Pitfalls

1. Page ID vs Page Title

• Problem: Trying to use page title when page ID is required
• Solution: Use confluence search cql "title = 'Page Name'" to find the page ID first

2. Version Conflicts

• Problem: Update fails due to concurrent edits (409 Conflict)
• Solution: Get the latest version, merge changes, retry update

3. Missing Parent Page

• Problem: Creating a child page with invalid parent ID
• Solution: Verify parent exists with confluence page get PARENT_ID

4. Content Format Mismatch

• Problem: Body content not rendering correctly
• Solution: Use --file with Markdown, or ensure proper ADF/storage format

5. Space Key Case Sensitivity

• Problem: Space key not found
• Solution: Space keys are case-sensitive (use uppercase: DOCS not docs)

6. Permanent Delete Recovery

• Problem: Accidentally used --permanent flag
• Solution: No recovery possible - always use trash (default) first

7. Blog Post Update/Delete

• Problem: Trying to update or delete a blog post using page commands
• Solution: Blog posts currently only support create and get operations via CLI. Update/delete must be done via Confluence UI.

---

Error Handling

Error	Cause	Resolution
404 Not Found	Page ID doesn't exist or was deleted	Verify page ID, check trash
403 Forbidden	No permission to access/modify page	Request space access, check restrictions
409 Conflict	Concurrent edit detected	Refresh page, merge changes, retry
400 Bad Request	Invalid content format or parameters	Check body format, verify arguments
413 Content Too Large	Page body exceeds size limit	Split content across multiple pages

Recovery from Errors

Deleted page recovery:

# Pages go to trash by default (recoverable for 30 days)
# Use Confluence UI: Space Settings > Content Tools > Trash > Restore

Version recovery:

# Check version history
confluence page versions 12345

# Restore previous version
confluence page restore 12345 --version 5

Permission issues:

# Check page restrictions
confluence permission page get 12345

# Check space permissions
confluence permission space get SPACE_KEY