Konverte Digital icon

Konverte Digital

Interact with Konverte Digital API

Actions115

Overview

This node operation deletes specified agents (users) from a team within an account in the Konverte Digital API. It is useful for managing team memberships by removing users who should no longer be part of a team. For example, if an agent leaves a support team, this operation can be used to remove their access from that team programmatically.

Use Case Examples

  1. Removing one or more agents from a customer support team by specifying their user IDs and the team ID within the account.
  2. Automating team membership updates by batch removing multiple users from a team based on changing team roles or assignments.

Properties

Name Meaning
Account Id The numeric ID of the account where the team exists. Required to identify the account context for the operation.
Team Id The ID of the team from which agents (users) will be deleted. Required to specify the target team.
User Ids A JSON array of user IDs representing the agents to be removed from the team. Required to specify which users to delete from the team.
Request Options Optional settings for the HTTP request such as batching, SSL certificate validation, proxy configuration, and timeout settings.

Output

JSON

  • success - Indicates whether the deletion operation was successful.
  • deletedUserIds - List of user IDs that were successfully removed from the team.
  • teamId - The ID of the team from which users were deleted.
  • accountId - The account ID associated with the team.

Dependencies

  • Requires an API key credential for authentication with the Konverte Digital API.

Troubleshooting

  • Common issues include invalid or missing account ID, team ID, or user IDs, which will cause the API to reject the request.
  • SSL certificate validation errors if the 'Ignore SSL Issues' option is not enabled and the server uses a self-signed or invalid certificate.
  • Timeout errors if the server does not respond within the specified timeout period.
  • Proxy misconfiguration if the proxy URL or credentials are incorrect, leading to failed requests.

Discussion