Actions168
- Bot Actions
- Call & Meeting Actions
- Channel Actions
- Add Bot to Channel
- Add Channel Members
- Approve Channel
- Archive Channel
- Change Channel Member Role
- Change Channel Permission
- Create Channel
- Delete Channel
- Get Channel
- Get Channel Members
- Join Channel
- Leave Channel
- List Channels
- Reject Channel
- Remove Bot From Channel
- Remove Channel Members
- Remove Single Channel Member
- Unarchive Channel
- Update Channel
- Chat Actions
- Cliq Database Actions
- Custom Domain Actions
- Custom Email Actions
- Department Actions
- Designation Actions
- Event Actions
- File Actions
- Maintenance (Bulk Export) Actions
- Message Actions
- Message Component Builder Actions
- OAuth Helper Actions
- Reaction Actions
- Reminder Actions
- Remote Work Actions
- Role Actions
- Team Actions
- Thread Actions
- User Actions
- User Field Actions
- User Status Actions
- Widget Map Ticker Actions
Message → Delete Message
AI-generatedSummary
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.