OpenProjectInstall

Overview

This node integrates with the OpenProject API to manage various resources such as projects, users, work packages, time entries, versions, types, statuses, priorities, and categories. Specifically, for the Category resource with the Update operation, it allows updating an existing category by its ID.

Typical use cases include automating project management workflows where categories need to be updated programmatically, for example:

• Changing the name or attributes of a category used to classify work packages.
• Synchronizing category data from another system into OpenProject.
• Bulk updating categories based on external triggers or schedules.

Properties

Note: The provided input properties only list Category ID because the bundled code does not show additional fields for updating categories explicitly. The update payload for categories is minimal or may rely on other parameters not shown here.

Output

The node outputs an array of JSON objects, each representing the response from the OpenProject API for the update request. The structure of the JSON output corresponds directly to the updated category resource returned by the API, typically including fields like the category's ID, name, and any other metadata managed by OpenProject.

No binary data output is produced by this node.

Dependencies

• Requires an active connection to the OpenProject API.
• Needs an API key credential configured in n8n for authentication.
• The base URL of the OpenProject instance must be specified in the credentials.
• Uses HTTP Basic Authentication with the API key encoded in Base64.

Troubleshooting

• Error: "The resource 'category' is not supported for update operation!"
  This error indicates that the node does not support updating categories, possibly due to missing implementation or incorrect resource/operation selection. Verify that the resource is set to "Category" and operation to "Update".

• API Error Responses:
  If the OpenProject API returns an error (e.g., invalid ID, permission denied), the node throws an error with the message from the API response. Check the category ID validity and API permissions.

• Authentication Issues:
  Ensure the API key credential is correctly configured and has sufficient rights to update categories.

• Missing Required Parameters:
  The Category ID must be provided; otherwise, the node will fail.

Links and References

• OpenProject API Documentation
• OpenProject Categories API Reference (for details on category fields and update operations)
• n8n Documentation on Credentials