delete-page

This skill MUST be used when the user asks to "delete a Confluence page", "remove a page", "delete a folder", "remove content from wiki", or wants to delete pages or folders from Confluence. ALWAYS use this skill for Confluence content deletion.

📖 中文导读:This skill MUST be used when the user asks to "delete a Confluence page", "remove a page", "delete a folder", "remove content from wiki", or wants to delete pages or folders from Confluence. ALWAYS use this skill for Confluence content deletion. 以下正文为该技能的原始 SKILL.md 内容(英文),上方安装命令可直接使用。

name: delete-page description: This skill MUST be used when the user asks to "delete a Confluence page", "remove a page", "delete a folder", "remove content from wiki", or wants to delete pages or folders from Confluence. ALWAYS use this skill for Confluence content deletion.

Delete Confluence Page or Folder

IMPORTANT: Always use this skill's Python script for deleting Confluence pages and folders. This skill auto-detects content type and handles both pages and folders.

Quick Start

Use the Python script at scripts/delete_confluence_page.py:

# Delete a page (auto-detect type)
python scripts/delete_confluence_page.py --id 123456

# Delete a folder explicitly
python scripts/delete_confluence_page.py --id 123456 --type folder

# Delete a page explicitly
python scripts/delete_confluence_page.py --id 123456 --type page

Options

Option Description
--id, -i Page or folder ID to delete (required)
--type, -t Content type: page, folder, auto (default: auto)
--format, -f Output: compact (default), text, json

Important Notes

  1. Children must be deleted first - You cannot delete a page or folder that has children. Delete the children first, or delete recursively starting from the deepest level.

  2. Deletion is permanent - Deleted content goes to the trash but should be treated as permanent. Use with caution.

  3. Auto-detection - By default, the script tries to find the content as a page first, then as a folder. Use --type to skip auto-detection if you know the type.

Common Workflows

Delete a Single Page

python scripts/delete_confluence_page.py --id 123456

Delete a Folder Structure (Bottom-Up)

When deleting a folder hierarchy, delete children first:

# First delete all pages in the folder
python scripts/delete_confluence_page.py --id 123459  # Child page 1
python scripts/delete_confluence_page.py --id 123460  # Child page 2

# Then delete the folder itself
python scripts/delete_confluence_page.py --id 123458 --type folder

Delete Multiple Pages

# Delete several pages
for id in 123456 123457 123458; do
  python scripts/delete_confluence_page.py --id $id
done

Output Formats

compact (default):

DELETED|123456|page|My Page Title

text:

Deleted: My Page Title
ID: 123456
Type: page

json:

{"id": "123456", "title": "My Page Title", "type": "page", "deleted": true}

Error Handling

Error Cause Solution
"not found" ID doesn't exist Verify the ID is correct
"has children" Content has child pages Delete children first
"permission denied" No delete permission Check your permissions

Environment Setup

Requires environment variables:

  • CONFLUENCE_BASE_URL - e.g., https://yoursite.atlassian.net
  • CONFLUENCE_EMAIL - Your Atlassian account email
  • CONFLUENCE_API_TOKEN - API token from Atlassian account settings