Delete a conversation message

Remove a single message (soft delete in production). The chat UI uses the REST client on the same service used for listing, per channel.

Endpoints

DELETE
/conversation-messages-whatsapp/:messageId
DELETE
/conversation-messages-instagram/:messageId
DELETE
/conversation-messages-messenger/:messageId
DELETE
/conversation-messages-webchat/:messageId
DELETE
/conversation-messages-sms/:messageId
DELETE
/conversation-messages-playground/:messageId

:messageId is the message primary key (_id string for WhatsApp-style stores, or numeric id for playground/SMS depending on the record).

Request

Response

Returns the updated message document (for example with deleted_at set) or an empty success body depending on adapter configuration.

Notes

  • Permission to delete may be restricted by role or channel policy.
  • After deletion, List conversation messages should no longer return that id unless your API includes deleted rows in queries.

Report an issue with this documentation

Please log in to report issues with our documentation.