Actions57
- Card Actions
- Card Builder Actions
- Channel Actions
- Chat Actions
- Message Actions
- Analyze Reactions
- Delete
- Delta (All Chats)
- Export All Messages (Metered)
- Export Retained Messages (Metered)
- Generate Thumbnail
- Get
- Get Many
- Get Pinned Messages
- Get Reaction Analytics
- List Messages
- List Replies
- Monitor Upload
- Pin Message
- Pin Channel Message
- Process File
- Reply
- Reply with Attachment
- Send
- Send and Wait
- Send File Link
- Send with Attachment
- Set Reaction
- Soft Delete
- Undo Delete
- Unpin Message
- Unpin Channel Message
- Unset Reaction
- Update
- Upload to OneDrive
- Subscriptions Actions
- Team Actions
- User Actions
Message → Soft Delete
AI-generatedSummary
Soft-delete a message in a Teams chat or channel using Microsoft Graph. Select the recipient type, then provide the message ID and its chat ID or the team and channel IDs.
Inputs
- recipientType (required) — Choose Chat (Direct Message) or Channel to identify where the message is located.
- chatId (required) — ID of the chat containing the message; used for chat messages.
- messageId (required) — ID of the message to soft-delete.
- teamId (required) — ID of the team containing the channel; used for channel messages.
- channelId (required) — ID of the channel containing the message; used for channel messages.
Output shape
One item per input item, containing the Graph API response for the soft-delete request.
The operation calls the chat or channel soft-delete endpoint according to recipient type. Only the identifiers relevant to that recipient are used; failures are reported as operation errors.
Examples
Example 1: For chat
Set recipientType to chat, and provide chatId and messageId.
Example 2: For channel
Set recipientType to channel, and provide teamId, channelId, and messageId.