OpenProject icon

OpenProject

Interact with OpenProject via API

Actions199

Overview

This node interacts with the OpenProject API to retrieve the status of a specific project. It is useful in scenarios where you want to monitor or display the current status of projects managed within OpenProject, such as tracking progress, identifying delays, or updating dashboards automatically.

For example, you might use this node in an automation workflow that checks the status of a project and sends notifications if the project is off track or requires attention.

Properties

Name Meaning
Id The identifier of the project status to view. Common values include statuses like "on_track", "at_risk", or "off_track". This property is required to specify which project status to retrieve.

Output

The node outputs JSON data representing the details of the requested project status. This typically includes fields such as the status id, name, description, and possibly metadata related to the project's current state.

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

  • Common issues:

    • Invalid or missing project status ID: Ensure the Id property matches a valid status identifier in your OpenProject instance.
    • Authentication errors: Verify that the API key credential is correctly set up and has sufficient permissions.
    • Network connectivity problems: Confirm that the n8n instance can reach the OpenProject server URL.
  • Error messages:

    • "Unauthorized" or "Authentication failed": Check API credentials.
    • "Not Found" when retrieving status: Validate the provided status ID.
    • Timeouts or connection errors: Inspect network settings and OpenProject server availability.

Links and References

Discussion