Confluence Cloud icon

Confluence Cloud

Access to the Confluence Cloud REST API - Auto-generated from OpenAPI

Overview

The "Delete Space" operation in the Confluence Cloud node allows you to permanently delete a Confluence space by specifying its unique space key. This deletion bypasses the trash and initiates a long-running task to remove the space, which means the space might not be immediately deleted when the request returns. Users should monitor the status link provided in the response to confirm completion.

This operation is useful for administrators who need to clean up or remove obsolete spaces from their Confluence instance programmatically. For example, automating the removal of project spaces after project completion or deleting test spaces created during development.

Properties

Name Meaning
Space Key The unique key identifier of the space to delete. This is required to specify which space will be removed.

Output

The output of this operation typically contains the response from the Confluence API regarding the deletion request. Since the deletion is handled as a long-running task, the response may include a status link that can be polled to check if the space has been fully deleted.

  • The json output field will contain the API response data related to the deletion request.
  • No binary data is expected from this operation.

Dependencies

  • Requires an active connection to a Confluence Cloud instance.
  • Requires an API authentication token or API key credential with sufficient permissions.
  • The user must have 'Admin' permission on the space to perform deletion.
  • The node configuration must include the domain URL of the Confluence Cloud instance.

Troubleshooting

  • Permission Errors: If the user lacks 'Admin' permission for the space, the API will reject the deletion request. Ensure the API credentials have appropriate permissions.
  • Space Not Found: Providing an incorrect or non-existent space key will result in an error. Verify the space key before attempting deletion.
  • Deletion Delay: Since deletion is asynchronous, the space may still appear until the long-running task completes. Poll the status link returned in the response to track progress.
  • API Rate Limits: Frequent deletion requests may hit API rate limits; handle such errors by implementing retries with backoff.

Links and References

Discussion