Zoho Cliq icon

Zoho Cliq

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

Actions168

Message → Delete Message

AI-generated

Summary

Delete a specific message from a Zoho Cliq chat by providing its Chat ID and Message ID, with options to handle errors flexibly and to receive enhanced success response metadata.

Inputs

  • Chat ID (required) — The Chat ID that contains the message to delete. This must be the exact chat's unique identifier and cannot be a Channel or Thread ID.
  • Message ID (required) — The ID of the message to delete within the specified chat.
  • Enable AI Error Mode — Optional boolean to return errors as output items instead of stopping execution, useful for workflows that should recover from API errors.
  • Include Enhanced Output — Optional boolean to control returning workflow-friendly success metadata. If disabled, returns Zoho Cliq's standard minimal or empty success response.

Output shape

a single JSON object per item representing the success metadata of the delete operation or the standard success response from Zoho Cliq API.

The delete operation permanently removes the message and cannot be undone. The API may reject deletion if the message is older than the account-configured delete window or if the authenticated user lacks permission, even for admin users. Errors can be returned as output items if AI Error Mode is enabled, allowing workflows to handle failures gracefully.

Examples

Example 1: Delete a message by specifying its Chat ID and Message ID, with enhanced output enabled to get detailed success information.

Set Chat ID to the target chat identifier, Message ID to the specific message to remove, and keep Include Enhanced Output on to true.

Links

Discussion