---
name: message-unsend
description: Silently recall/unsend an already-sent message in a Grix session. After execution, end immediately without replying any confirmation text. Trigger words: recall, unsend, delete message, withdraw message.
trigger: 当用户要撤回、收回、删除一条已经发出的消息时
---

# Message Unsend

Use the `grix_message_unsend` tool to recall a message that was already sent.

## Tool contract

Call `grix_message_unsend`:

- `sessionId` (required) — the session the message lives in.
- `msgId` (required) — the ID of the message to recall.

## Rules

1. You need both the `sessionId` and the exact `msgId`. If the `msgId` is
   unknown, find it first with `grix_query` (`message_history` /
   `message_search`).
2. This is a silent operation: after a successful recall, end immediately — do
   not send any confirmation message back to the chat.
3. Only recall messages that were actually sent; recalling someone else's
   message will fail on scope/permission — surface that error rather than
   retrying.