Actions31
Overview
The node integrates with the Steuerboard API to manage users within a client context. Specifically, the "User" resource's "Update" operation allows updating details of an existing user identified by their User ID and Client ID. This is useful in scenarios where user information such as name or role needs to be modified programmatically, for example, updating a user's role from regular user to admin or correcting their first or last name.
Practical examples include:
- Changing a user's role after a promotion.
- Correcting typos in user names.
- Updating user details during onboarding or offboarding processes.
Properties
| Name | Meaning |
|---|---|
| Client ID | The unique identifier of the client under which the user exists. |
| User ID | The unique identifier of the user to update. |
| Fields | Collection of fields to update on the user: |
| First Name | The new first name of the user. |
| Last Name | The new last name of the user. |
| Role | The role assigned to the user. Options: "Admin" (full access), "User" (limited access). |
Output
The node outputs JSON data representing the updated user object as returned by the Steuerboard API. This typically includes the user's updated properties such as first name, last name, role, and identifiers. There is no indication that binary data is output by this node.
Dependencies
- Requires an active connection to the Steuerboard API via an API key credential.
- The base URL for the API must be configured in the node credentials.
- The node depends on the Steuerboard API being accessible and the provided Client ID and User ID being valid.
Troubleshooting
- Invalid Client ID or User ID: If these IDs are incorrect or do not exist, the API will likely return an error indicating the resource was not found. Verify the IDs before running the node.
- Insufficient Permissions: Attempting to update a user without proper permissions may result in authorization errors. Ensure the API key has sufficient rights.
- Missing Required Fields: The node requires both Client ID and User ID. Omitting these will cause validation errors.
- API Connectivity Issues: Network problems or incorrect base URL configuration can cause request failures. Check network connectivity and credential settings.
- Invalid Role Value: Only "admin" or "user" roles are accepted. Providing other values may cause errors.
Links and References
- Steuerboard API Documentation (general reference for API endpoints and user management)
- n8n Documentation on creating and using custom nodes with API integrations