AvantGuard - ClerkChat icon

AvantGuard - ClerkChat

AvantGuard - ClerkChat

Overview

This node operation, "Remove Users From Inbox" under the "Reseller" resource, allows users to remove one or more specified users from a particular inbox within a team. It is useful in scenarios where an administrator or reseller needs to manage user access to communication channels by revoking inbox permissions for certain users.

Practical examples include:

  • Removing former employees from a team's shared inbox to prevent them from accessing ongoing conversations.
  • Managing user roles dynamically by removing users who no longer require access to specific inboxes.
  • Automating cleanup of user access when teams or projects change.

Properties

Name Meaning
Team Id The unique identifier of the team that owns the inbox.
Inbox Id The unique identifier of the inbox from which users will be removed.
User Ids An array of user IDs representing the users to be removed from the specified inbox.

Output

The node outputs JSON data reflecting the result of the removal operation. This typically includes confirmation of success or failure and may contain details about the updated state of the inbox or affected users. There is no indication that binary data is output by this node.

Dependencies

  • Requires an API key credential for authentication with the AvantGuard ClerkChat service.
  • Needs proper configuration of the base URL for the API endpoint via credentials.
  • Depends on the external AvantGuard ClerkChat API to perform the user removal action.

Troubleshooting

  • Missing or invalid Team Id or Inbox Id: Ensure these identifiers are correct and correspond to existing entities in the system.
  • Invalid User Ids format: The User Ids property must be a valid JSON array of user ID strings. Malformed JSON or incorrect data types can cause errors.
  • Authentication errors: Verify that the API key credential is correctly configured and has sufficient permissions.
  • API connectivity issues: Check network connectivity and the correctness of the API base URL.
  • Error messages from API: These might indicate permission issues, non-existent users, or other domain-specific problems. Review the API response message for guidance.

Links and References

Discussion