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 retrieve user information. Specifically, the "User" resource with the "Get All" operation allows you to fetch a list of all users in the Bitbucket Data Center instance.

Common scenarios where this node is beneficial include:

  • Synchronizing user lists from Bitbucket Data Center into other systems.
  • Auditing or reporting on users who have access to repositories.
  • Automating workflows that depend on user data from Bitbucket Data Center.

For example, you could use this node to get all users and then filter or process them to send notifications or update permissions elsewhere.

Properties

Name Meaning
Authentication Method used for authentication: either "Personal Access Token" or "Basic Auth".
Return All Whether to return all user results or limit the number of returned users.
Limit Maximum number of user results to return if "Return All" is false (range 1-500).

Output

The output is a JSON array where each element represents a user object retrieved from the Bitbucket Data Center API. Each user object contains details such as username, display name, email address, and other metadata provided by the API.

No binary data is output by this node.

Example output snippet (simplified):

[
  {
    "name": "jdoe",
    "displayName": "John Doe",
    "emailAddress": "jdoe@example.com",
    ...
  },
  {
    "name": "asmith",
    "displayName": "Alice Smith",
    "emailAddress": "asmith@example.com",
    ...
  }
]

Dependencies

  • Requires an active Bitbucket Data Center instance accessible via its REST API.
  • Requires credentials configured in n8n for authentication, either:
    • A personal access token credential.
    • Basic authentication credential.
  • The node uses the Bitbucket Data Center REST API endpoint /rest/api/1.0/users to fetch user data.

Troubleshooting

  • Authentication errors: Ensure the provided API token or basic auth credentials are valid and have sufficient permissions to read user data.
  • API request failures: Network issues or incorrect server URL configuration can cause failures. Verify the Bitbucket Data Center server URL is correct and reachable.
  • Limit and pagination: If not returning all users, ensure the "Limit" property is set within allowed bounds (1-500). To get more than 500 users, enable "Return All".
  • Unsupported operations: Only "Get" and "Get All" operations are supported for the User resource. Attempting other operations will result in errors.

Error messages from the node typically indicate API request failures with messages like:

Bitbucket Data Center API request failed: <error message>

Resolving these usually involves checking credentials, network connectivity, and API permissions.

Links and References

Discussion