Confluence Cloud

Overview

The "Delete Page" operation in the Confluence Cloud node allows users to delete a specific page by its ID. This operation supports deleting both published and draft pages. When deleting a non-draft page, it moves the page to the trash, from where it can be restored later. To permanently delete (purge) a trashed page, an additional parameter must be set. Similarly, drafts can be deleted directly without moving to trash.

This operation is useful for managing content lifecycle in Confluence, such as cleaning up outdated or irrelevant pages, removing drafts that are no longer needed, or permanently purging pages to free up space.

Practical examples:

• Automatically delete a page after a project is completed.
• Remove draft pages that were abandoned.
• Permanently purge trashed pages to maintain a clean workspace.

Properties

Output

The output JSON contains the response from the Confluence API after attempting to delete the specified page. Typically, this will be an empty response or a confirmation of deletion depending on the API's behavior.

No binary data is involved in this operation.

Dependencies

• Requires an authenticated connection to Confluence Cloud via an API key credential.
• The base URL for API requests is configured from the user's credentials (domain).
• Proper permissions are required:
  • Permission to view the page and its corresponding space.
  • Permission to delete pages in the space.
  • Permission to administer the space if attempting to purge.

Troubleshooting

• Common issues:

  • Insufficient permissions: Users must have appropriate rights to delete or purge pages.
  • Invalid page ID: Ensure the page ID exists and is accessible.
  • Attempting to purge a page without admin rights will fail.
  • Trying to delete a draft page without setting the draft flag may not work as expected.

• Error messages:

  • 403 Forbidden: Indicates lack of necessary permissions. Verify user roles and permissions.
  • 404 Not Found: The specified page ID does not exist or is inaccessible.
  • 400 Bad Request: Possibly due to incorrect parameters like missing id or invalid flags.

• Resolution:

  • Confirm the page ID is correct.
  • Check user permissions in Confluence.
  • Use the draft flag when deleting draft pages.
  • Use the purge flag only when permanently deleting trashed pages and ensure admin rights.

Links and References

• Confluence Cloud REST API Documentation
• Deleting Content in Confluence API
• Confluence Permissions Overview