OpenProject icon

OpenProject

Interact with OpenProject via API

Actions199

Overview

This node operation lists all versions available in a specified project within OpenProject. It is useful for users who want to retrieve version information such as release or milestone versions associated with a particular project. Typical use cases include tracking software releases, managing project milestones, or integrating version data into other workflows.

For example, a project manager might use this node to fetch all versions of a software project to display them in a dashboard or to trigger notifications when new versions are released.

Properties

Name Meaning
Id The numeric ID of the project whose versions you want to list. This is a required field and identifies the specific project in OpenProject.

Output

The node outputs JSON data containing the list of versions available in the specified project. Each item in the output typically includes details about a version such as its identifier, name, status, description, and relevant dates (e.g., release date). The exact structure depends on the OpenProject API response but generally provides comprehensive version metadata.

No binary data output is expected from this operation.

Dependencies

  • Requires an API key credential for authenticating with the OpenProject API.
  • The node expects the base URL of the OpenProject instance to be configured in the credentials.
  • Internet access to communicate with the OpenProject API endpoint.

Troubleshooting

  • Invalid Project ID: If the provided project ID does not exist or is incorrect, the node may return an error or empty results. Verify the project ID before running the node.
  • Authentication Errors: Ensure that the API key credential is valid and has sufficient permissions to access project version data.
  • Network Issues: Connectivity problems can cause request failures. Check network settings and OpenProject server availability.
  • API Changes: If OpenProject updates their API, the node might fail until updated accordingly.

Links and References

Discussion