Bitbucket Data Center

Overview

This node integrates with the Bitbucket Data Center API to manage projects, repositories, pull requests, branches, commits, users, and issues (though issue operations are not supported directly). Specifically for the Project - Create operation, it allows users to create a new project in their Bitbucket Data Center instance by specifying key details such as the project key, name, and an optional description.

Common scenarios where this node is beneficial include automating project setup workflows, integrating Bitbucket project creation into CI/CD pipelines, or managing multiple projects programmatically without manual intervention.

Example use case: Automatically creating a new project in Bitbucket Data Center when a new client onboarding process starts, ensuring consistent naming conventions and descriptions.

Properties

Output

The output JSON contains the response from the Bitbucket Data Center API after creating the project. This typically includes details about the newly created project such as its key, name, description, links, and other metadata returned by the API.

If the creation is successful, the output will be a JSON object representing the project resource. If there is an error, the node will throw an error unless configured to continue on failure.

No binary data output is produced by this operation.

Dependencies

• Requires access to a Bitbucket Data Center instance.
• Requires either a Personal Access Token or Basic Authentication credentials configured in n8n.
• The node uses the Bitbucket Data Center REST API endpoint /rest/api/1.0/projects to create projects.
• Proper permissions on the Bitbucket server to create projects are necessary.

Troubleshooting

• Common issues:

  • Invalid or missing authentication credentials will cause API request failures.
  • Using a project key that already exists will result in an error from the Bitbucket API.
  • Insufficient permissions to create projects on the Bitbucket server.
  • Network connectivity issues to the Bitbucket Data Center server.

• Error messages:

  • "Bitbucket Data Center API request failed: <message>": Indicates a failure in the API call; check credentials, URL, and network.
  • "The operation \"create\" is not supported for resource \"project\"": Should not occur for create operation but indicates misuse of the node parameters.
  • Errors related to invalid project key or name will come from the Bitbucket API and should be resolved by correcting input values.

• Resolution tips:

  • Verify the API base URL and credentials.
  • Ensure the project key is unique and follows Bitbucket's requirements.
  • Confirm user permissions on Bitbucket Data Center.
  • Enable "Continue On Fail" in the node settings to handle errors gracefully during batch executions.

Links and References

• Bitbucket Data Center REST API Documentation - Projects
• Bitbucket Data Center Authentication
• n8n Documentation - Creating Custom Nodes