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

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

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