Skip to main content

message_deleted message

A message was deleted

Facts

Required Scopes
Compatible APIs

Usage info​

This example includes both the event wrapper and the event structure for the message_deleted message subtype event.

{
    "token": "XXYYZZ",
    "team_id": "T123ABC456",
    "api_app_id": "A123ABC456",
    "event": {
        "type": "message",
        "subtype": "message_deleted",
        "hidden": true,
        "channel": "C123ABC456",
        "ts": "1358878755.000001",
        "deleted_ts": "1358878749.000002"
    },
    "type": "event_callback",
    "authed_users": [
        "U123ABC456",
        "U222222222"
    ],
    "event_id": "Ev123ABC456",
    "event_time": 123456789
}

A message_deleted message is sent when a message in a channel is deleted, usually via the chat.delete method.

The deleted_ts property gives the timestamp of the message that was deleted.

If clients find an existing message with the same deleted_ts and channel, the existing message should be removed from the local model and UI. The original message will no longer return in history calls.

All types of messages are eligible for deletion, not just user-sent messages.