Delete A Conversation - CometChat Docs

Quick Reference

// Delete a user conversation
CometChat.deleteConversation("UID", "user");

// Delete a group conversation
CometChat.deleteConversation("GUID", "group");

Available via: SDK | REST API | UI Kits

In case you want to delete a conversation, you can use the deleteConversation() method. This method takes two parameters: the unique ID (UID/GUID) of the conversation to be deleted, and the type (user/group) of conversation to be deleted.

Deleting a conversation is an irreversible operation for the logged-in user. Once deleted, the conversation and its associated data cannot be recovered for that user.

To User
To Group
TypeScript (User)
TypeScript (Group)

let UID = "UID";
let type = "user";
CometChat.deleteConversation(UID, type).then(
  deletedConversation => {
      console.log(deletedConversation);
  }, error => {
      console.log('error while deleting a conversation', error);
  }
);

let GUID = "GUID";
let type = "group";
CometChat.deleteConversation(GUID, type).then(
  deletedConversation => {
      console.log(deletedConversation);
  }, error => {
      console.log('error while deleting a conversation', error);
  }
);

let UID: string = "UID";
let type: string = "user";
CometChat.deleteConversation(UID, type).then(
  (deletedConversation: string) => {
      console.log(deletedConversation);
  }, (error: CometChat.CometChatException) => {
      console.log('error while deleting a conversation', error);
  }
);

let GUID: string = "GUID";
let type: string = "group";
CometChat.deleteConversation(GUID, type).then(
  (deletedConversation: string) => {
      console.log(deletedConversation);
  }, (error: CometChat.CometChatException) => {
      console.log('error while deleting a conversation', error);
  }
);

Response

On Success — deleteConversation() returns a success message:

Parameter	Type	Description	Sample Value
`message`	string	Confirmation message	`"Conversation deleted successfully."`

This method deletes the conversation only for the logged-in user. To delete a conversation for all the users of the conversation, please refer to our REST API documentation here. The deleteConversation() method takes the following parameters:

Parameter	Description	Required
conversationWith	`UID` of the user or `GUID` of the group whose conversation you want to delete.	YES
conversationType	The type of conversation you want to delete. It can be either `user` or `group`.	YES

Best Practices

Always confirm with the user before deleting a conversation, as this action is irreversible for the logged-in user.
Handle the error callback gracefully to inform users if the deletion fails (e.g., due to network issues or invalid IDs).
After a successful deletion, update your local conversation list by refreshing it using ConversationsRequest.

Troubleshooting

Conversation not found: Ensure the UID or GUID you are passing is correct and that a conversation with that user or group exists.
Permission denied: Verify that the logged-in user has the appropriate permissions and that the SDK is initialized and the user is logged in.
Type mismatch: Make sure the conversationType parameter matches the ID you are passing — use "user" with a UID and "group" with a GUID.

Next Steps

Retrieve Conversations

Fetch and display the list of conversations for the logged-in user.

Delete a Message

Remove individual messages from a conversation.

Receive Messages

Listen for and handle incoming real-time messages.

Messaging Overview

Explore the full set of messaging capabilities available in the SDK.

​Next Steps

Retrieve Conversations

Delete a Message

Receive Messages

Messaging Overview

Next Steps