delete_chat_message

Soft delete a chat message that was previously sent. Only the message sender can delete their own messages. The message will be marked as deleted but can still be seen as

Server Teams @floriscornel/teams-mcp
Category Destructive
Risk class Critical
Parameters 00 required

What delete_chat_message does on Teams

AI agents call delete_chat_message to permanently remove resources in Teams — typically in cleanup and lifecycle workflows. It does its job in a single call, and there is no undo.

Why delete_chat_message needs a policy

This tool removes chat message data from the Teams conversation. Although described as a 'soft delete' (marked as deleted rather than fully purged), it irreversibly removes the message from normal view and access, preventing recovery of the original message content by standard means. This fits the Destructive category as it cannot be undone by normal operations.

From the tool's definition Tool name is 'delete_chat_message' and description states it performs a 'Soft delete a chat message that was previously sent.' The action is irreversible deletion of message content.

Questions about delete_chat_message

What does the delete_chat_message tool do? +

Soft delete a chat message that was previously sent. Only the message sender can delete their own messages. The message will be marked as deleted but can still be seen as. It is categorised as a Destructive tool in the Teams MCP Server, which means it can permanently delete or destroy data. Block by default and require explicit approval.

How do I enforce a policy on delete_chat_message? +

Register the Teams MCP server in PolicyLayer and add a rule for delete_chat_message: allow, deny, rate-limit, or require approval. Point your MCP client at the PolicyLayer proxy URL and the rule is enforced on every call, before it reaches Teams. Nothing to install.

What risk level is delete_chat_message? +

delete_chat_message is a Destructive tool with critical risk. Critical-risk tools should be blocked by default and only enabled with explicit human approval.

Can I rate-limit delete_chat_message? +

Yes. Add a rate_limit block to the delete_chat_message rule in your PolicyLayer policy. For example, setting max: 10 and window: 60 limits the tool to 10 calls per minute. Rate limits are tracked per agent session and reset automatically.

How do I block delete_chat_message completely? +

Set action: deny in the PolicyLayer policy for delete_chat_message. The AI agent will receive a policy violation error and cannot call the tool. You can also include a reason field to explain why the tool is blocked.

What MCP server provides delete_chat_message? +

delete_chat_message is provided by the Teams MCP server (@floriscornel/teams-mcp). PolicyLayer sits as a proxy in front of this server to enforce policies before tool calls reach the server.

// GET IN TOUCH

Have a question or want to learn more? Send us a message.

Message sent.

We'll get back to you soon.