Actions109
- Activity Actions
- Assets Actions
- Authentication Actions
- Collections Actions
- Extensions Actions
- Fields Actions
- Files Actions
- Folders Actions
- Items Actions
- Permissions Actions
- Presets Actions
- Relations Actions
- Revisions Actions
- Roles Actions
- Settings Actions
- Users Actions
- Utilities Actions
- Webhooks Actions
Users → Update
AI-generatedOverview
The Directus (DrWade) n8n node for the resource Users and operation Update allows you to update an existing user in your Directus instance. This is achieved by sending a PATCH request to the Directus API with the specified user ID and the fields you wish to update.
Common scenarios:
- Updating user profile information such as name, email, or role.
- Modifying custom fields on user records.
- Automating user management tasks, e.g., updating user status based on workflow logic.
Practical example:
You could use this node in an onboarding workflow to automatically assign a new title or department to a user after they complete a training module.
Properties
| Name | Type | Meaning |
|---|---|---|
| ID | String | Primary key of the user. This uniquely identifies which user record to update. |
| Data (JSON) | JSON | A partial user object. Contains the fields and values to update for the user. |
Output
- The output will be a single
jsonobject representing the updated user record as returned by the Directus API. - The structure of the output matches the Directus user object, including only the fields that were updated or are returned by the API.
- Example output:
{ "id": "72a1ce24-4748-47de-a05f-ce9af3033727", "email": "user@example.com", "first_name": "Jane", "last_name": "Doe", "title": "CTO", ... }
Dependencies
- Directus API: You must have access to a running Directus instance.
- API Credentials: The node requires valid Directus API credentials configured in n8n under the name
directusApi. - n8n Configuration: No special environment variables are required beyond standard credential setup.
Troubleshooting
Common issues:
- Invalid User ID: If the provided ID does not match any user, the API will return an error.
- Malformed Data (JSON): If the
Data (JSON)property is not valid JSON or does not conform to the expected user object schema, the update will fail. - Insufficient Permissions: The API credentials used must have permission to update users in Directus.
- Error Handling: If an error occurs and "Continue On Fail" is enabled, the output will contain an
errorfield with the error message.
Common error messages:
"User not found": The ID does not correspond to any user."Invalid payload": The data sent is not valid JSON or contains invalid fields."Forbidden": The API credentials do not have sufficient permissions.
How to resolve:
- Double-check the user ID.
- Validate your JSON using a linter or online tool.
- Ensure your API credentials have the correct permissions.