delete_message

delete_message(**kwargs)

Sends an event to a specific room which directs clients to delete a specific message; that is, unrender it from view and delete it from the client’s chat history. This event’s EventName is aws:DELETE_MESSAGE . This replicates the DeleteMessage WebSocket operation in the Amazon IVS Chat Messaging API.

See also: AWS API Documentation

Request Syntax

response = client.delete_message(
    id='string',
    reason='string',
    roomIdentifier='string'
)

Parameters

• id (string) --

  [REQUIRED]

  ID of the message to be deleted. This is the Id field in the received message (see Message (Subscribe) in the Chat Messaging API).

• reason (string) -- Reason for deleting the message.
• roomIdentifier (string) --

  [REQUIRED]

  Identifier of the room where the message should be deleted. Currently this must be an ARN.

Return type

dict

Returns

Response Syntax

{
    'id': 'string'
}

Response Structure

• (dict) --

  • id (string) --

    Operation identifier, generated by Amazon IVS Chat.

Exceptions

• ivschat.Client.exceptions.ThrottlingException
• ivschat.Client.exceptions.AccessDeniedException
• ivschat.Client.exceptions.ResourceNotFoundException
• ivschat.Client.exceptions.PendingVerification
• ivschat.Client.exceptions.ValidationException