Delete a message

DELETE {{baseUrl}}/chat/users/:userId/messages/:messageId?to_contact=<email>&to_channel=<string>

Deletes a chat message previously sent to a contact or a channel. For user-level apps, pass the me value instead of the userId parameter.

For an account-level OAuth app, this API can only be used on behalf of a user who is assigned with a role that has the Edit permission for Chat Messages.

Scopes: chat_message:write, chat_message:write:admin
Rate Limit Label: Medium

Request Params

KeyDatatypeRequiredDescription
to_contactstringThe member ID or user ID or email address of a chat contact to whom the message was sent. You must provide this parameter or the to_channel parameter.
to_channelstringThe channel ID where the message was sent. You must provide this parameter or the to_channel parameter.