Bitbucket Data Center icon

Bitbucket Data Center

Interact with Bitbucket Data Center API
Join our community

Actions50

Overview

This node interacts with the Bitbucket Data Center API to manage projects and other related resources. Specifically, for the Project - Get operation, it retrieves detailed information about a single project identified by its project key. This is useful when you want to fetch metadata or configuration details of a specific project within your Bitbucket Data Center instance.

Common scenarios include:

  • Automating workflows that require project details before performing further actions.
  • Integrating Bitbucket project data into dashboards or reporting tools.
  • Validating project existence or properties as part of CI/CD pipelines.

Example: You might use this node to get the description, name, and key of a project before creating repositories or pull requests under that project.

Properties

Name Meaning
Authentication Method used to authenticate with Bitbucket Data Center API. Options: Personal Access Token, Basic Auth
Project The project key identifying the project to retrieve. Loaded dynamically from available projects in Bitbucket Data Center

Output

The output is a JSON object representing the project details as returned by the Bitbucket Data Center API. It typically includes fields such as:

  • key: The unique project key.
  • name: The project name.
  • description: Description of the project.
  • Other metadata provided by the Bitbucket API about the project.

If the project is successfully retrieved, the output will be a single JSON object with these details.

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.

Troubleshooting

  • Authentication errors: Ensure the provided credentials (access token or basic auth) are valid and have sufficient permissions to read project data.
  • Project not found: Verify the project key is correct and exists in the Bitbucket Data Center instance.
  • API request failures: Network issues or incorrect server URL configuration can cause failures. Confirm the server URL is reachable and correct.
  • Error message example:
    Bitbucket Data Center API request failed: <error message>
    This indicates an issue with the API call; check credentials, network, and parameters.

Links and References

Discussion