Actions43
- Project Actions
- User Actions
- Work Package Actions
- Time Entry Actions
- Version Actions
- Type Actions
- Status Actions
- Priority Actions
- Category Actions
Overview
This node integrates with the OpenProject API to manage project-related resources. Specifically, for the Version - Create operation, it allows users to create a new version within a specified project in OpenProject. This is useful for teams that want to automate version management as part of their project lifecycle, such as creating release versions or milestones programmatically.
Practical examples include:
- Automatically creating a new software release version when a build pipeline completes.
- Adding version entries based on external triggers or schedules without manual input.
- Integrating version creation into broader workflows involving project and work package management.
Properties
| Name | Meaning |
|---|---|
| Project ID | The unique identifier of the project to which the new version will belong. |
| Name | The name of the version to be created (e.g., "v1.0", "Release Candidate 2"). |
Output
The node outputs JSON data representing the newly created version resource as returned by the OpenProject API. This typically includes fields such as the version's ID, name, associated project, and other metadata provided by the API response.
No binary data output is produced by this operation.
Dependencies
- Requires an active connection to an OpenProject instance via its REST API.
- Needs an API key credential configured in n8n for authentication.
- The base URL of the OpenProject server and the API key must be set in the node credentials.
- Uses HTTP Basic Authentication with the API key encoded in Base64.
Troubleshooting
Common issues:
- Invalid or missing Project ID: Ensure the project ID exists and is correctly entered.
- Authentication errors: Verify that the API key credential is valid and has sufficient permissions.
- Network connectivity problems: Confirm that the OpenProject server is reachable from the n8n environment.
Error messages:
OpenProject error response: <message>: Indicates an error returned by the OpenProject API, often due to invalid input or permission issues. Check the message for details.The resource 'version' is not supported!: This would occur if the resource parameter is incorrectly set; ensure "version" is selected.The method '<method>' is not supported!: Indicates an unsupported HTTP method was attempted; this should not happen under normal usage.
To resolve errors, verify all required parameters, check API credentials, and consult OpenProject API documentation for correct usage.