OpenProject icon

OpenProject

Interact with OpenProject via API
Join our community

Actions199

Overview

This node operation allows you to create a new work package in OpenProject via its API. Work packages are units of work or tasks within a project management context, and this node helps automate their creation with detailed attributes such as subject, description, scheduling, and links to other entities like project, status, or assignee.

Common scenarios include:

  • Automatically generating tasks from external triggers or workflows.
  • Creating structured work items with scheduling details for project planning.
  • Integrating OpenProject task creation into broader automation pipelines.

For example, you could use this node to create a work package when a new issue is reported in a bug tracking system, including setting the start and due dates, assigning responsible users, and linking it to a specific project.

Properties

Name Meaning
Subject The title or subject of the work package.
Description Detailed description of the work package, supporting markdown format. It expects a JSON object with format, raw, and html fields describing the content.
Schedule Manually Boolean flag indicating if the work package should be scheduled manually (true) or automatically (false).
Start Date Scheduled start date/time of the work package.
Due Date Scheduled end date/time of the work package.
Estimated Time Estimated time required to complete the work package, excluding any sub-tasks or descendants.
Duration Duration in hours needed to complete the work package. Must be at least one day (P1D), and will be floored to the nearest day. Only effective if start or due date is set. Not applicable for milestone-type work packages.
Ignore Non Working Days Boolean flag indicating whether non-working days should be ignored during scheduling. If true, the work package can be scheduled on non-working days.
Links JSON object containing references (links) to related entities such as category, type, priority, project, status, responsible user, assignee, version, and parent work package. These define relationships and metadata.

Output

The node outputs the created work package data in the json field of the output item. This typically includes all properties of the newly created work package as returned by the OpenProject API, such as its ID, subject, description, scheduling info, and linked entities.

No binary data output is indicated for this operation.

Dependencies

  • Requires an API key credential for authenticating with the OpenProject API.
  • The node uses the OpenProject REST API endpoint configured via credentials, including the base URL.
  • Proper permissions in OpenProject are necessary to create work packages.

Troubleshooting

  • Authentication errors: Ensure the API key and base URL are correctly configured in the node credentials.
  • Validation errors: Missing required fields like subject or invalid date formats may cause API rejections. Verify input values conform to expected types and formats.
  • Scheduling conflicts: Setting contradictory scheduling options (e.g., duration without start/due date) might lead to unexpected behavior or errors.
  • Link references: Incorrect or incomplete _links JSON structure may cause failures; ensure referenced entities exist and are properly formatted.

Links and References

Discussion