Bitbucket Data Center icon

Bitbucket Data Center

Interact with Bitbucket Data Center API

Overview

This node integrates with the Bitbucket Data Center API to manage projects, including deleting a project. Specifically, for the Project - Delete operation, it allows users to delete an existing project identified by its project key.

Common scenarios where this node is beneficial include:

  • Automating cleanup of obsolete or test projects in Bitbucket.
  • Integrating project lifecycle management into CI/CD pipelines.
  • Managing projects programmatically without manual intervention in the Bitbucket UI.

For example, you might use this node in a workflow that deletes a project after all associated repositories have been archived or migrated.

Properties

Name Meaning
Authentication Method of authentication to use: either "Personal Access Token" or "Basic Auth".
Project The project to work with, selected from a dynamically loaded list of available projects.

Output

The output JSON object for the Delete Project operation contains a simple success indicator:

{
  "success": true
}

This indicates that the project was successfully deleted. If the deletion fails, an error will be thrown instead.

No binary data is produced by this operation.

Dependencies

  • Requires access to a Bitbucket Data Center instance with appropriate permissions to delete projects.
  • Requires configuration of credentials in n8n for either Personal Access Token or Basic Authentication.
  • The node uses the Bitbucket Data Center REST API endpoint /rest/api/1.0/projects/{projectKey} with HTTP DELETE method.

Troubleshooting

  • Permission errors: Deleting a project requires sufficient privileges. Ensure the API token or basic auth user has admin rights on the Bitbucket server.
  • Project not found: If the specified project key does not exist, the API will return an error. Verify the project key is correct and exists.
  • API request failures: Network issues or incorrect server URL in credentials can cause request failures. Check connectivity and credential configuration.
  • Unsupported operation error: This node only supports defined operations; ensure the resource is set to "Project" and operation to "Delete".

If an error occurs, the node throws an error message prefixed with Bitbucket Data Center API request failed: followed by the specific issue message.

Links and References

Discussion