Delete Message
cascade_delete_messagePermanently remove a message from your mailbox. This action is irreversible; archive messages for retention.
Instructions
Permanently delete a message from the authenticated user's Cascade mailbox.
This is a DESTRUCTIVE operation — once deleted, the message cannot be recovered (archive is not the same as recycle-bin for messages). Prefer cascade_mark_message with markType: "archive" for retention. Messages must belong to the authenticated user; you cannot delete messages in another user's mailbox.
Args:
identifier (object, required): The message to delete
id (string, required): Message ID (from cascade_list_messages)
type (string, required): Must be "message"
Returns: Cascade OperationResult: { success: true } On failure: { success: false, message: "" }
Examples:
Use when: "Permanently clear spam-like notifications" -> { identifier: { type: "message", id: "..." } }
Don't use when: You want to hide it without deleting — use cascade_mark_message with markType: "archive".
Don't use when: You want to delete in bulk — this deletes one message per call.
Error Handling:
"Message not found" when the identifier doesn't resolve
"Permission denied" when the message belongs to another user. Responses are JSON text; structuredContent is authoritative when the response fits. Oversized responses return bounded _cache metadata for cascade_read_response. For cascade_read, read_mode controls preview versus raw Cascade payload shape.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| identifier | No | The message to delete. |