Bitbucket Data Center icon

Bitbucket Data Center

Interact with Bitbucket Data Center API

Actions29

Overview

This node integrates with the Bitbucket Data Center API to retrieve user information. Specifically, the "User" resource with the "Get" operation allows you to fetch details about a specific user by their username or, if no username is provided, information about the current authenticated user.

Common scenarios where this node is beneficial include:

  • Automating workflows that require fetching user profile details for reporting or auditing.
  • Integrating Bitbucket user data into other systems or dashboards.
  • Validating user existence or retrieving user metadata during CI/CD pipeline processes.

For example, you can use this node to get the email and display name of a particular user in your Bitbucket Data Center instance or to confirm the identity of the currently authenticated user.

Properties

Name Meaning
Authentication Method of authentication to use: either "Personal Access Token" or "Basic Auth".
Username The username of the user to retrieve information for. Leave empty to get the current user.

Output

The node outputs JSON data representing the user information retrieved from the Bitbucket Data Center API. The structure depends on whether a specific username was provided or not:

  • If a username is specified, the output contains detailed information about that user.
  • If no username is specified, the output contains information about the current authenticated user.

Typical fields returned may include user ID, display name, email address, active status, and other profile-related data as defined by the Bitbucket Data Center API.

The node does not output binary data.

Dependencies

  • Requires access to a Bitbucket Data Center instance.
  • Requires an API authentication credential configured in n8n, either:
    • A Personal Access Token credential, or
    • Basic Authentication credential (username and password).
  • The node uses the Bitbucket Data Center REST API endpoints under /rest/api/1.0/user or /rest/api/1.0/users/{username}.

Troubleshooting

  • Authentication errors: Ensure that the provided Personal Access Token or Basic Auth credentials are valid and have sufficient permissions to access user information.
  • User not found: If specifying a username, verify that the username exists in the Bitbucket Data Center instance.
  • API request failures: Network issues or incorrect server URLs can cause request failures. Confirm the server URL is correct and accessible.
  • Unsupported operations: Only "get" and "getAll" operations are supported for the User resource. Using other operations will result in errors.
  • Error messages: Errors from the API are wrapped and presented as Bitbucket Data Center API request failed: <error message>. Check the error message for details and adjust parameters or credentials accordingly.

Links and References

Discussion