Bitbucket Data Center icon

Bitbucket Data Center

Interact with Bitbucket Data Center API

Overview

The node integrates with Bitbucket Data Center's API to manage projects, repositories, pull requests, and other related resources. Specifically, the Project - Update operation allows users to update an existing project's details such as its name and description.

This node is beneficial in automation workflows where you need to programmatically maintain or modify project metadata in Bitbucket Data Center without manual intervention. For example, you could automate renaming a project or updating its description based on external triggers or data changes.

Properties

Name Meaning
Authentication Method of authentication: either "Personal Access Token" or "Basic Auth".
Project The key of the project to update. This is selected from available projects.
Project Name The new name for the project.
Description Optional updated description for the project.

Output

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

If the update operation fails, the node throws an error unless configured to continue on failure, in which case the output will contain an error message.

Dependencies

  • Requires access to a Bitbucket Data Center instance.
  • Requires credentials for authentication, either a personal access token or basic authentication.
  • The node uses Bitbucket Data Center REST API endpoints under /rest/api/1.0/projects/{projectKey}.
  • Proper permissions are needed on the Bitbucket server to update project details.

Troubleshooting

  • Common issues:

    • Invalid or expired credentials causing authentication failures.
    • Insufficient permissions to update the specified project.
    • Providing a non-existent project key.
    • Network connectivity issues to the Bitbucket server.
  • Error messages:

    • "Bitbucket Data Center API request failed: ..." indicates an issue with the API call, often due to authentication or permission problems.
    • "The operation "update" is not supported for resource "project" would indicate a misconfiguration or unsupported operation (unlikely here since update is supported).
  • Resolutions:

    • Verify that the API credentials are correct and have necessary scopes/permissions.
    • Confirm the project key exists and is accessible.
    • Check network connectivity and Bitbucket server availability.
    • Enable "Continue On Fail" in the node settings to handle errors gracefully during batch operations.

Links and References

Discussion