Actions113
- Accounts Actions
- Account Users Actions
- Agent Bots Actions
- Users Actions
- Inbox API Actions
- Contacts API Actions
- Conversations API Actions
- Messages API Actions
- CSAT Survey Page Actions
- Account Agent Bots Actions
- Agents Actions
- Canned Responses Actions
- Canned Response Actions
- Custom Attributes Actions
- Contacts Actions
- Contact Actions
- Automation Rule Actions
- Help Center Actions
- Conversations Actions
- Conversation Assignment Actions
- Conversation Labels Actions
- Inboxes Actions
- Messages Actions
- Integrations Actions
- Webhooks Actions
- Teams Actions
- Custom Filters Actions
- Reports 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 a support team member no longer handles certain customer queries, you can use this operation to delete their access from that team.
Properties
| Name | Meaning |
|---|---|
| Account Id | The numeric ID of the account to which the team belongs. |
| Team Id | The ID of the team from which agents will be removed. |
| User Ids | A JSON array containing the IDs of users (agents) to be deleted from the specified team. |
Output
The output contains a JSON object representing the result of the deletion operation. Typically, this includes confirmation of which users were successfully removed from the team or any error messages related to the operation. There is no binary data output for this operation.
Dependencies
- Requires an API key credential to authenticate with the ChatWoot API.
- The node uses the ChatWoot API base URL configured in the credentials.
- The operation sends a request to the ChatWoot API endpoint responsible for managing team memberships.
Troubleshooting
- Invalid Account or Team ID: If the provided account or team ID does not exist, the API will return an error. Verify these IDs before running the node.
- Malformed User Ids JSON: The
User Idsproperty expects a valid JSON array. Ensure the input is correctly formatted JSON; otherwise, parsing errors may occur. - Insufficient Permissions: The API key used must have permissions to modify team memberships. Lack of proper authorization will cause failures.
- Network Issues: Connectivity problems with the ChatWoot API endpoint can cause timeouts or connection errors.
Links and References
- ChatWoot API Documentation (for detailed API endpoints and authentication)
- n8n Documentation on Using Credentials