Chats

Bulk-delete the message history of a chat from the MAM archive

Auth: Tenant Actor

Removes every mod_mam row attached to a single chat room. Generic — same scope as the GET sibling: works for any chat type. The chat row itself is not deleted (callers that want the conversation gone entirely also call DELETE /v2/apps/{appId}/chats with the chat's name). Used by the admin AI Widget Conversations cleanup flow but generally useful for any "clear transcript" operation.

Idempotent — calling on an already-empty chat returns { deletedCount: 0 }.

Installs without the MAM_MYSQL_* env vars get mamUnavailable: true and a no-op response so the UI can render a "history not deletable on this deployment" hint rather than fail.

delete/v2/apps/{appId}/chats/{chatId}/messages

Request

  • Base URL: https://api.chat.ethora.com
  • URL: https://api.chat.ethora.com/v2/apps/{appId}/chats/{chatId}/messages
  • Auth: one of:
    • HTTP bearer
    • HTTP bearer

Path parameters

appIdstring required

Target App ID. Must be an app the calling actor owns or has been delegated access to.

chatIdstring required

Mongo _id of the chat row.

Response 

{
  deletedCount: number,
  chat: { _id: string, name: string, type: string },
  mamUnavailable: boolean
}

Changes

No recorded changes to this operation across all 1 revision of this API.