Actions43
- Project Actions
- User Actions
- Work Package Actions
- Time Entry Actions
- Version Actions
- Type Actions
- Status Actions
- Priority Actions
- Category Actions
Overview
This node updates an existing Work Package in OpenProject via its API. It allows users to modify various attributes of a Work Package such as its subject, description, status, priority, assignee, dates, estimated time, completion percentage, version, and category.
Common scenarios include:
- Adjusting the progress or details of a task or issue tracked as a Work Package.
- Reassigning tasks to different team members.
- Updating deadlines or priorities based on project changes.
- Adding descriptive information or linking the Work Package to specific versions or categories.
For example, a project manager could use this node to update the status and due date of a Work Package after a sprint planning meeting.
Properties
| Name | Meaning |
|---|---|
| Project ID | The ID of the project that the Work Package belongs to. |
| Work Package ID | The unique identifier of the Work Package to update. |
| Subject | The main title or subject line of the Work Package. |
| Additional Fields | Optional fields to further specify or update details of the Work Package: |
| - Description | A textual description providing more details about the Work Package. |
| - Status ID | The ID representing the current status of the Work Package (e.g., open, closed). |
| - Priority ID | The ID indicating the priority level of the Work Package (e.g., high, low). |
| - Assignee ID | The ID of the user assigned to the Work Package. |
| - Start Date | The planned start date/time for the Work Package. |
| - Due Date | The deadline or due date/time for completing the Work Package. |
| - Estimated Time | The estimated effort required, formatted as a duration string (e.g., PT1H30M for 1 hour 30 minutes). |
| - Percentage Done | Completion percentage of the Work Package, from 0 to 100. |
| - Version ID | The ID of the version associated with the Work Package. |
| - Category ID | The ID of the category under which the Work Package is classified. |
Output
The node outputs JSON data representing the updated Work Package resource as returned by the OpenProject API. This includes all fields of the Work Package after the update operation.
No binary data output is produced by this node.
Dependencies
- Requires an active OpenProject instance accessible via its REST API.
- Needs an API key credential configured in n8n for authentication.
- Uses HTTP Basic Authentication with the API key encoded in the request headers.
- Relies on the axios library for making HTTP requests.
Troubleshooting
Common issues:
- Invalid or missing Project ID or Work Package ID will cause errors.
- Incorrect API key or base URL configuration leads to authentication failures.
- Providing invalid field values (e.g., wrong date format or non-existent IDs) may result in API errors.
Error messages:
- Errors from the OpenProject API are surfaced with their message, e.g.,
"OpenProject error response: <message>". - Network or unexpected errors show the raw error message.
- Errors from the OpenProject API are surfaced with their message, e.g.,
Resolutions:
- Verify that all required IDs correspond to existing resources in OpenProject.
- Ensure the API key credential is correctly set up and has sufficient permissions.
- Validate date formats and other field inputs before running the node.
- Use "Continue On Fail" option in n8n if partial processing is acceptable.