Actions113
- Contacts Actions
- Contact Actions
- Automation Rule Actions
- Help Center Actions
- Conversations Actions
- Conversation Assignment Actions
- Conversation Labels Actions
- Inboxes Actions
- Messages Actions
- Integrations Actions
- Teams Actions
- Custom Filters Actions
- Webhooks Actions
- Reports Actions
- Accounts Actions
- Account Users Actions
- Agent Bots Actions
- Users Actions
- Contacts API Actions
- Inbox API Actions
- Conversations API Actions
- Messages API Actions
- CSAT Survey Page Actions
- Account Agent Bots Actions
- Agents Actions
- Canned Responses Actions
- Custom Attributes Actions
- Canned Response Actions
Overview
This node operation allows you to remove one or more agents (users) from a specific team within an account. It is useful in scenarios where you need to manage team membership dynamically, such as when agents leave a team or are reassigned. For example, if you want to revoke access for certain users from a support team, this operation will delete those users from the team.
Properties
| Name | Meaning |
|---|---|
| Account Id | The numeric ID of the account that owns the team. |
| Team Id | The ID of the team from which agents (users) will be removed. |
| User Ids | A JSON array containing the IDs of users to be deleted from the specified team. |
Output
The output contains a JSON object representing the result of the deletion operation. Typically, this would include confirmation of the users removed or the updated state of the team membership. There is no indication that binary data is returned by this operation.
Dependencies
- Requires an API key credential to authenticate with the ChatWoot API.
- The base URL for the API must be configured in the node credentials.
- The node uses the ChatWoot REST API endpoint related to teams and user management.
Troubleshooting
- Invalid Account or Team ID: If the provided account or team ID does not exist or is incorrect, the API will likely return an error indicating the resource was not found. Verify the IDs before running the node.
- Malformed User IDs JSON: The
User Idsproperty expects a valid JSON array of numeric user IDs. Invalid JSON or incorrect formatting will cause parsing errors. Ensure the JSON is well-formed. - Authentication Errors: Missing or invalid API credentials will prevent the node from executing successfully. Confirm that the API key and base URL are correctly set in the node credentials.
- Permission Issues: The authenticated user must have sufficient permissions to modify team membership. Lack of permissions will result in authorization errors.
Links and References
- ChatWoot API Documentation - Official API docs for managing accounts, teams, and users.
- n8n Documentation - General information on how to configure credentials and use HTTP-based nodes.