OpenProject

Interact with OpenProject via API

Actions199

Collections Actions
- View Aggregated Result
Forms Actions
- Show Or Validate Form
Actions Capabilities Actions
- List Actions
- View Action
- List Capabilities
- View Capabilities
Activities Actions
- View Activity
- Update Activity
Attachments Actions
- Delete Attachment
- View Attachment
- List Attachments By Meeting
- Add Attachment To Meeting
- List Attachments By Post
- Add Attachment To Post
- List Attachments By Wiki Page
- Add Attachment To Wiki Page
- List Work Package Attachments
- Create Work Package Attachment
Budgets Actions
- View Budget
- View Budgets Of A Project
Categories Actions
- View Category
- List Categories Of A Project
Custom Actions Actions
- Get Custom Action
- Execute Custom Action
Custom Options Actions
- View Custom Option
Documents Actions
- List Documents
- View Document
File Links Actions
- View File Link
- Delete File Link
- Open File Link
- Download File Link
- List Project Storages
- Get Project Storage
- Open Project Storage
- Create Storage
- Get Storage
- Update Storage
- Delete Storage
- Get Storage Files
- Prepare Storage File Upload
- Create Storage Folder
- Create Storage Oauth Credentials
- Open Storage
- Create Work Package File Link
- List Work Package File Links
Grids Actions
- List Grids
- Create Grid
- Get Grid
- Update Grid
- Grid Update Form
Groups Actions
- List Groups
- Create Group
- Delete Group
- Get Group
- Update Group
Help Texts Actions
- Get Help Text
Memberships Actions
- List Memberships
- Create Membership
- Form Create Membership
- Delete Membership
- Get Membership
- Update Membership
- Form Update Membership
Query Filter Instance Schema Actions
- List Query Filter Instance Schemas For Project
- View Query Filter Instance Schema
News Actions
- List News
- Create News
- View News
- Update News
- Delete News
Notifications Actions
- List Notifications
- Read Notifications
- Unread Notifications
- View Notification
- View Notification Detail
- Read Notification
- Unread Notification
O Auth 2 Actions
- Get Oauth Application
- Get Oauth Client Credentials
Posts Actions
- View Post
Principals Actions
- List Placeholder Users
- Create Placeholder User
- Delete Placeholder User
- View Placeholder User
- Update Placeholder User
- List Principals
- List Users
- Create User
- Delete User
- View User
- Update User
Priorities Actions
- View Priority
Query Columns Actions
- View Query Column
Query Filters Actions
- View Query Filter
Query Operators Actions
- View Query Operator
Query Sort Bys Actions
- View Query Sort By
Relations Actions
- List Relations
- Get Relation
- Delete Relation
- Update Relation
- Create Relation
Previewing Actions
- Preview Markdown Document
Revisions Actions
- View Revision
Roles Actions
- List Roles
- View Role
Time Entries Actions
- List Time Entries
- Create Time Entry
- Time Entry Update Form
- Delete Time Entry
- Get Time Entry
- Update Time Entry
Time Entry Activities Actions
- Get Time Entries Activity
Types Actions
- List Types Available In A Project
- View Type
User Preferences Actions
- Update User Preferences
Wiki Pages Actions
- View Wiki Page
Work Schedule Actions
- List Non Working Days
- Create Non Working Day
- View Non Working Day
- Update Non Working Day
- Delete Non Working Day
- Update Week Days
- View Week Day
- Update Week Day
- List Days
- View Day
Meetings Actions
- View Meeting
Values Property Actions
- View Notification Detail
- View Values Schema
Projects Actions
- List Projects
- Create Project
- Delete Project
- View Project
- Update Project
- Project Update Form
- Create Project Copy
- Project Copy Form
- View Project Status
- List Available Parent Project Candidates
- List Projects With Version
Queries Actions
- View Default Query For Project
- View Schema For Project Queries
- List Queries
- Create Query
- View Default Query
- Query Create Form
- Delete Query
- View Query
- Edit Query
- Query Update Form
- Star Query
- Unstar Query
Users Actions
- Update User
- List Users
- Create User
- Delete User
- View User
- User Update Form
- Unlock User
- Lock User
Statuses Actions
- Get Status
Versions Actions
- List Versions Available In A Project
- List Versions
- Delete Version
- View Version
- Update Version
- Version Update Form
Work Packages Actions
- Get Project Work Package Collection
- Create Project Work Package
- List Work Package File Links
- Form Create Work Package In Project
- Project Available Assignees
- List Work Packages
- Create Work Package
- Form Create Work Package
- List Work Package Schemas
- View Work Package Schema
- Delete Work Package
- View Work Package
- Update Work Package
- List Work Package Activities
- Comment Work Package
- Work Package Available Assignees
- Available Projects For Work Package
- List Available Relation Candidates
- Available Watchers
- Create Work Package File Link
- Form Edit Work Package
- Revisions
- Reminders
- List Watchers
- Add Watcher
- Remove Watcher
Views Actions
- List Views
- View View
- Create Views
- Get Custom Field Items
- Get Custom Field Item
- Get Custom Field Item Branch

Overview

This node operation updates a placeholder user in the "Principals" resource of an external system (likely OpenProject, based on context). It allows you to modify the name of an existing placeholder user identified by their unique ID. This is useful in scenarios where placeholder users are used as temporary or generic accounts and need to be renamed for clarity or organizational purposes.

Practical examples:

Renaming a generic placeholder user to reflect a new project role.
Updating placeholder user names during data cleanup or migration processes.

Properties

Name	Meaning
Id	The unique identifier of the placeholder user to update. Must be provided as a number.
Name	The new name to assign to the placeholder user. This is a string value representing the updated display name.

Output

The node outputs JSON data representing the updated placeholder user object returned from the API after the update operation. This typically includes fields such as the user's id, updated name, and possibly other metadata related to the placeholder user.

No binary data output is involved in this operation.

Dependencies

Requires an API key credential for authenticating with the external service's API.
The base URL for the API must be configured in the node credentials.
The node uses standard HTTP headers for JSON content negotiation (Accept: application/json and Content-Type: application/json).

Troubleshooting

Invalid or missing Id: If the placeholder user ID is not provided or invalid, the API will likely return an error indicating that the resource was not found or the request is malformed.
Authentication errors: Ensure that the API key credential is correctly set up and has sufficient permissions to update placeholder users.
Name validation issues: If the new name does not meet the API’s requirements (e.g., length or character restrictions), the API may reject the update.
Network or connectivity problems: Verify that the base URL is correct and accessible from the n8n environment.

Links and References

Refer to the external system’s API documentation for the "Principals" resource and placeholder user management endpoints.
General REST API usage guidelines for updating resources via PATCH or PUT methods.

OpenProjectInstall