Skip to main content
DELETE
Delete Message
Deletes a message. The behavior differs based on who is deleting:
  • Author self-delete: The message is soft-deleted. The row is retained as a [Message deleted] placeholder — content, GIF, mentions, and metadata are cleared, and userDeletedAt is set. File attachments are deleted from storage.
  • Group admin moderation delete: The message is marked moderationStatus: "removed" and excluded from all future queries. Content is not cleared; the record is retained for moderation audit purposes.
The caller must be either the message author or a group admin.

Path Parameters

conversationId
string
required
The ID of the conversation.
messageId
string
required
The ID of the message to delete.

Response

For author self-delete:
For admin moderation:

Error Responses