Zoho Cliq icon

Zoho Cliq

Fully manage your Zoho Cliq workspace: messages, channels, teams, users, databases, events, reminders, bots, files, and more

Actions168

Channel → Remove Channel Members

AI-generated

Summary

Removes specified users or bots from a selected Zoho Cliq channel via the API.

Inputs

  • channelId (required) — Select a channel from the list, or specify a Channel ID or unique name.
  • memberIdentifiers (required) — Comma-separated member identifiers to remove. Use only email IDs or only user IDs in one request (mixed types are rejected). Each identifier is removed with a separate API call.
  • enableAiErrorMode — Whether to return errors as output items instead of stopping execution. Recommended for AI Tool runs that should recover from API errors.
  • includeEnhancedOutput — Whether to return workflow-friendly success metadata. Disable to return Cliq's standard response (typically empty for success).

Output shape

A list of items containing the API response data for each member removal (one item per identifier unless AI Error Mode is enabled).

Each member identifier results in a separate API call. If 'Enable Enhanced Output' is disabled, successful responses are typically empty. The operation requires the ZohoCliq.Channels.UPDATE scope.

Examples

Example 1: Bulk removal of inactive team members

Select a team channel, provide a comma-separated list of user emails to remove, and keep 'Enable Enhanced Output' on to see results.

Example 2: Automated cleanup of guest users

Connect to a list of users, use an expression to populate 'Member Identifiers' with their emails, and enable AI Error Mode to handle partial failures gracefully.

Links

Discussion