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
The "Update A Team" operation in the Teams resource allows users to modify the details of an existing team within their account. This node is useful for managing team configurations dynamically, such as changing a team's name, description, or auto-assignment settings without manually updating them through the user interface.
Practical examples include:
- Renaming a support team to reflect organizational changes.
- Updating the description to provide clearer context about the team's responsibilities.
- Enabling or disabling automatic assignment of conversations to agents within the team.
Properties
| Name | Meaning |
|---|---|
| Account Id | The numeric ID of the account where the team exists. |
| Team Id | The unique identifier of the team to be updated. |
| Name | The new name for the team. |
| Description | A textual description providing details about the team. |
| Allow Auto Assign | Boolean flag indicating if conversations assigned to the team should automatically assign to an agent within that team (true or false). |
Output
The node outputs JSON data representing the updated team object returned by the API after the update operation. This typically includes the team's current properties such as its ID, name, description, and auto-assign setting reflecting the changes made.
No binary data output is involved in this operation.
Dependencies
- Requires an API key credential for authenticating with the ChatWoot API.
- The base URL for the ChatWoot instance must be configured in the credentials.
- The node depends on the ChatWoot REST API being accessible and the user having appropriate permissions to update teams.
Troubleshooting
- Invalid Account or Team ID: If the provided account or team ID does not exist or is incorrect, the API will return an error. Verify these IDs before running the node.
- Authentication Errors: Ensure the API key credential is valid and has sufficient permissions.
- Empty Required Fields: The
Account IdandTeam Idare required; missing these will cause the node to fail. - API Connectivity Issues: Network problems or incorrect base URL configuration can prevent successful API calls.
- Permission Denied: The authenticated user may lack rights to update the specified team.
Links and References
- ChatWoot API Documentation (for detailed API endpoints and payloads)
- n8n Documentation on Creating Custom Nodes