OpenProject icon

OpenProject

Interact with OpenProject via API

Actions199

Overview

This node allows you to view details of a specific Work Package in OpenProject by its ID. It is useful for retrieving up-to-date information about project tasks, issues, or work items tracked within OpenProject. You can also request baseline comparisons of the work package attributes at different points in time by providing timestamps.

Practical examples:

  • Fetching the current status and details of a task by its ID.
  • Comparing how a work package's attributes have changed over time using baseline timestamps.
  • Integrating OpenProject work package data into automated workflows for reporting or notifications.

Properties

Name Meaning
Id The unique identifier of the work package you want to view. This is a required numeric value.
Timestamps Optional comma-separated list of ISO-8601 formatted timestamps (absolute or relative) used to perform baseline comparisons of the work package attributes. Relative formats include keywords like oneDayAgo@HH:MM+HH:MM, lastWorkingDay@HH:MM+HH:MM, etc., where HH:MM is zero-padded hours and minutes, and +HH:MM is the timezone offset from UTC. The first timestamp usually represents the baseline date, and the last one the current date. Older values require an Enterprise Token.

Output

The node outputs JSON data representing the detailed information of the requested work package. This includes all standard fields returned by the OpenProject API for a work package, such as status, description, dates, assigned users, and any baseline comparison data if timestamps were provided.

No binary data output is produced by this node.

Dependencies

  • Requires an active connection to an OpenProject instance via its REST API.
  • Needs an API authentication token credential configured in n8n to authorize requests.
  • For baseline comparisons with timestamps older than 1 day, a valid Enterprise Token is required on the OpenProject server.

Troubleshooting

  • Invalid or missing Work Package ID: Ensure the "Id" property is set correctly and corresponds to an existing work package in your OpenProject instance.
  • Authentication errors: Verify that the API key or token credential is correctly configured and has sufficient permissions.
  • Timestamp format issues: Make sure timestamps are in valid ISO-8601 format or use supported relative keywords exactly as specified. Incorrect formatting may cause the API to reject the request.
  • Enterprise Token required: If requesting baseline comparisons with timestamps older than 1 day, ensure your OpenProject instance has a valid Enterprise Token; otherwise, the request will fail.
  • Network or connectivity problems: Confirm that the base URL and network access to the OpenProject API are correct and reachable.

Links and References

Discussion