Bitbucket Data Center icon

Bitbucket Data Center

Interact with Bitbucket Data Center API

Project → Get

AI-generated

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