Deleting chat messages - Amazon Chime

You must be an Amazon Chime system administrator to complete the steps in this guide. If you need help with the Amazon Chime desktop client, web app, or mobile app, see Getting support in the Amazon Chime User Guide.

Deleting chat messages

To comply with data retention policies, Amazon Chime retains all chat messages, and it prevents end users from deleting the messages that they send. However, Amazon Chime system administrators can use a pair of APIs to delete individual messages from conversations and chat rooms. The messages must reside in the administrator's Amazon Chime account.

Users can request message deletion by sending you a message ID and a corresponding conversation or chat room ID. The topic Using chat features, in the Amazon Chime User Guide, explains how.

When you get a deletion request, you can write code or use the AWS CLI to invoke the following APIs.

To remove a message
  • Do one of the following:

    • For conversation messages – Use the RedactConversationMessage API.

      In the CLI, run the following command:

      aws chime redact-conversation-message --conversation-id id_string --message-id id_string

    • For chat room messages – Use the RedactRoomMessage API.

      In the CLI, run the following command:

      aws chime redact-room-message --room-id id_string --message-id id_string