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 manage projects and other related resources. Specifically, for the Project - Get All operation, it retrieves a list of all projects available in the Bitbucket Data Center instance. This is useful for scenarios where you want to fetch and process multiple projects programmatically, such as generating reports, syncing project data with other systems, or automating project audits.

Practical examples include:

  • Automatically listing all projects to display in a dashboard.
  • Feeding project data into downstream workflows for analysis or notifications.
  • Bulk processing or filtering projects based on custom criteria.

Properties

Name Meaning
Authentication Method used to authenticate API requests. Options: "Personal Access Token", "Basic Auth"
Return All Whether to return all projects or limit the number of results
Limit Maximum number of projects to return (applicable if "Return All" is false). Range: 1-500

Output

The output is a JSON array where each element represents a project object retrieved from the Bitbucket Data Center API. Each project object typically contains fields such as project key, name, description, and other metadata as provided by the API.

Example structure of one project item (simplified):

{
  "key": "PROJ",
  "name": "Project Name",
  "description": "Description of the project",
  // additional project metadata fields...
}

No binary data output is produced by this operation.

Dependencies

  • Requires access to a Bitbucket Data Center instance.
  • Requires credentials for authentication, either via a personal access token or basic authentication.
  • The node uses the Bitbucket Data Center REST API endpoints under /rest/api/1.0/projects.
  • Proper configuration of the API server URL and credentials in n8n is necessary.

Troubleshooting

  • Authentication errors: Ensure that the provided API token or basic auth credentials are valid and have sufficient permissions to read projects.
  • API request failures: Network issues or incorrect server URLs can cause failures. Verify the Bitbucket Data Center server URL is correct and accessible.
  • Limit parameter ignored: If "Return All" is set to true, the "Limit" parameter is ignored; ensure settings align with expected behavior.
  • Empty results: Confirm that there are projects available in the Bitbucket Data Center instance and that the authenticated user has permission to view them.
  • Error messages: Errors from the API are wrapped and presented as Bitbucket Data Center API request failed: <message>. Check the message for details and verify API access and parameters.

Links and References

Discussion