SuperAPI AI Directory
Partner with us中文AI newsFavorites
Skillsconfluence-page

confluence-page

General & other

View repository

Updated 10-15 21:55

About this skill

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