Bitbucket Data Center

Overview

This node integrates with the Bitbucket Data Center API to manage projects within a Bitbucket Data Center instance. Specifically, the "Update Project" operation allows users to modify an existing project's details such as its name and description.

Common scenarios where this node is beneficial include:

• Automating project metadata updates in Bitbucket Data Center as part of CI/CD pipelines.
• Synchronizing project information from other systems or user inputs.
• Managing project lifecycle programmatically without manual intervention in the Bitbucket UI.

For example, you can use this node to rename a project or update its description based on changes in your organizational structure or project scope.

Properties

Output

The output JSON contains the updated project object returned by the Bitbucket Data Center API after a successful update. This typically includes fields such as the project key, updated name, description, and other metadata provided by the API.

Example output structure (simplified):

{
  "key": "PROJ",
  "name": "New Project Name",
  "description": "Updated project description",
  "public": false,
  "type": "NORMAL",
  ...
}

No binary data is produced by this operation.

Dependencies

• Requires access to a Bitbucket Data Center server with API enabled.
• Requires credentials configured in n8n for authentication, either via a personal access token or basic authentication.
• The node uses the Bitbucket Data Center REST API endpoint /rest/api/1.0/projects/{projectKey} with HTTP PUT method to perform the update.

Troubleshooting

• Error: "Bitbucket Data Center API request failed"
  This indicates a failure in communicating with the Bitbucket server. Check that the server URL is correct, the API is accessible, and the credentials are valid.

• Error: "The operation 'update' is not supported for resource 'project'"
  This would occur if the operation parameter is incorrect or unsupported. Ensure the operation is set to "update" when working with the "Project" resource.

• Missing required parameters
  The projectKey and name properties are mandatory. Omitting these will cause errors. Make sure these fields are correctly filled.

• Permission issues
  The authenticated user must have sufficient permissions to update projects in Bitbucket Data Center. Lack of permissions will result in authorization errors.

Links and References

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