Delete Conversation

Learn how to delete user and group conversations from the logged-in user’s conversation list using the CometChat Flutter SDK.

AI Integration Quick Reference

// Delete a user conversation
await CometChat.deleteConversation(
  "UID",
  CometChatConversationType.user,
  onSuccess: (String message) => debugPrint("Deleted: $message"),
  onError: (CometChatException e) => debugPrint("Error: ${e.message}"),
);

// Delete a group conversation
await CometChat.deleteConversation(
  "GUID",
  CometChatConversationType.group,
  onSuccess: (String message) => debugPrint("Deleted: $message"),
  onError: (CometChatException e) => debugPrint("Error: ${e.message}"),
);

Note: Deletes only for the logged-in user. Use REST API to delete for all participants.

This operation is irreversible. Deleted conversations cannot be recovered. All messages in the conversation will be removed from the user’s view.

Use deleteConversation() to delete a conversation for the logged-in user.

Available via: SDK | REST API | UI Kits

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.

Delete User Conversation

String conversationWith = "UID";
String conversationType = CometChatConversationType.user;
await CometChat.deleteConversation(conversationWith, conversationType,
   onSuccess: (String str){
     debugPrint("Conversation deleted successfully at : $str");
   },
   onError: (CometChatException e){
     debugPrint("Conversation deletion failed : ${e.message}");
  	}
);

Delete Group Conversation

String conversationWith = "GUID";
String conversationType = CometChatConversationType.group;
await CometChat.deleteConversation(conversationWith, conversationType,
   onSuccess: (String str){
     debugPrint("Conversation deleted successfully at : $str");
   },
   onError: (CometChatException e){
     debugPrint("Conversation deletion failed : ${e.message}");
  	}
); 

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 the REST API documentation.

Parameter	Type	Description	Required
conversationWith	String	UID of the user or GUID of the group whose conversation you want to delete.	Yes
conversationType	String	The type of conversation to delete. Use CometChatConversationType.user or CometChatConversationType.group.	Yes

Response

On Success — A String message confirming the conversation was deleted:

Parameter	Type	Description	Sample Value
message	string	Success confirmation message	"cometchat-uid-1_user_cometchat-uid-2 deleted successfully"

Error

Parameter	Type	Description	Sample Value
code	string	Error code identifier	"ERR_CHAT_API_FAILURE"
message	string	Human-readable error message	"Failed to delete the conversation."
details	string	Additional technical details	"The specified conversation could not be found or deleted."

---

Next Steps

Retrieve Conversations

Fetch and filter conversation lists

Delete Messages

Delete individual messages from conversations

Receive Messages

Listen for incoming messages in real-time

Typing Indicators

Show when users are typing in conversations