Bitbucket Data Center icon

Bitbucket Data Center

Interact with Bitbucket Data Center API

Actions29

Overview

This node interacts with the Bitbucket Data Center API to manage issues within a specified project. Specifically, the "Get All" operation for the "Issue" resource retrieves multiple issues associated with a project.

However, it is important to note that direct issue operations are not supported by the Bitbucket Data Center API itself. Instead, this node implementation explicitly throws an error advising users to use Jira integration for issue management. Therefore, while the node interface includes issue-related options, actual issue retrieval or manipulation via this node is not possible.

Practical Use Case

  • If you want to automate issue tracking and management in your development workflow, you would typically use Jira integration nodes rather than this Bitbucket Data Center node.
  • This node is more suited for managing projects, repositories, pull requests, branches, commits, and users in Bitbucket Data Center.

Properties

Name Meaning
Authentication Method of authentication: "Personal Access Token" or "Basic Auth".
Project The key of the project to work with (required).
Return All Whether to return all results or only up to a given limit (boolean).
Limit Maximum number of results to return if "Return All" is false (number between 1 and 500).

Output

  • Since the "Get All" operation for issues is not supported, the node will throw an error instead of returning data.
  • For other resources and operations (not requested here), the output is typically an array of JSON objects representing the retrieved entities (e.g., projects, repositories).
  • No binary data output is involved in this node.

Dependencies

  • Requires connection to a Bitbucket Data Center server.
  • Requires either a Personal Access Token or Basic Authentication credentials configured in n8n.
  • The node uses the Bitbucket Data Center REST API endpoints under /rest/api/1.0/.
  • No additional external services are required for this node itself, but for issue management, Jira integration is recommended.

Troubleshooting

  • Error: Issue operations are not directly supported in Bitbucket Data Center. Please use Jira integration instead.
    Cause: Attempting to perform any issue operation (including "Get All") on Bitbucket Data Center.
    Resolution: Use the Jira integration node in n8n to manage issues instead of this node.

  • API Request Failures: Errors like Bitbucket Data Center API request failed: ... indicate problems with authentication, network connectivity, or incorrect API endpoint URLs.
    Resolution:

    • Verify that the API credentials are correct and have sufficient permissions.
    • Ensure the Bitbucket Data Center server URL is reachable from n8n.
    • Check that the selected authentication method matches the provided credentials.
  • Empty Results: If no issues or projects are returned, verify that the project key is correct and that there are existing issues/projects in Bitbucket Data Center.

Links and References

Discussion