OpenProjectInstall

Overview

This node updates an existing user in the "Principals" resource of the OpenProject system via its API. It is useful for managing user accounts programmatically, such as changing user details or permissions without manual intervention in the OpenProject UI.

Common scenarios include:

• Automating user management workflows in project management environments.
• Synchronizing user data from external systems.
• Updating user roles or contact information in bulk.

For example, you could update a user's email and admin status after they change departments or roles within your organization.

Properties

Output

The node outputs JSON data representing the updated user object returned by the OpenProject API. This typically includes all user fields such as id, name, email, admin status, and other metadata reflecting the new state after the update.

No binary data output is produced by this node.

Dependencies

• Requires an API key credential for authenticating with the OpenProject API.
• The base URL of the OpenProject instance must be configured in the node credentials.
• The node uses standard HTTP headers for JSON content negotiation.

Troubleshooting

• Invalid User ID: If the provided user ID does not exist, the API will return an error. Verify the ID before updating.
• Password Update Ignored: Attempts to update the password will be ignored since it is only writable on user creation.
• Status Update Ignored: Similarly, status changes are only allowed during creation, so updates to this field will have no effect.
• Authentication Errors: Ensure the API key credential is valid and has sufficient permissions to update users.
• Missing Required Fields: All required fields (Id, Admin, Email, Login, First Name, Last Name, Language) must be provided; otherwise, the request will fail.

Links and References

• OpenProject API Documentation
• OpenProject User Management