Delete A Group

Permanently delete groups as an admin using the Android SDK

Quick Reference for AI Agents & Developers

// Delete a group (admin only)
CometChat.deleteGroup("GUID", object : CometChat.CallbackListener<String>() {
    override fun onSuccess(message: String) { }
    override fun onError(e: CometChatException) { }
})

Note: Only group admins can delete groups. This action is permanent and cannot be undone.

Available via: SDK | REST API | UI Kits

Delete Group

To delete a group, use the deleteGroup() method. The user must be an Admin of the group they are trying to delete.

Java

private String GUID = "GUID";

CometChat.deleteGroup(GUID, new CometChat.CallbackListener<String>() {
  @Override
  public void onSuccess(String successMessage) {
    Log.d(TAG, "Group deleted successfully: ");
  }

  @Override
  public void onError(CometChatException e) {
    Log.d(TAG, "Group delete failed with exception: " + e.getMessage());
  }
});

Kotlin

val GUID:String="GUID"

CometChat.deleteGroup(GUID,object :CometChat.CallbackListener<String>(){
  override fun onSuccess(p0: String?) {
    Log.d(TAG, "Groups deleted successfully: ")
  }

  override fun onError(p0: CometChatException?) {
    Log.d(TAG, "Group delete failed with exception: " +p0?.message)
  }
})

The deleteGroup() method takes the following parameters:

Parameter	Description
GUID	The GUID of the group you want to delete

Best Practices

Confirm Before Deleting

Always prompt users to confirm deletion with a clear warning that this action is permanent and will remove all group messages and data.

Verify Admin Permissions

Check the user’s scope before showing delete options. Only admins can delete groups.

Notify Members Before Deletion

Consider sending a notification or message to group members before deleting the group to give them time to save important information.

Troubleshooting

Delete Failed - Insufficient Permissions

Symptom: deleteGroup() fails with “Insufficient permissions” error.

Cause: User is not an admin of the group.

Solution: Only group admins can delete groups. Check the user’s scope using group.getScope() before attempting deletion.

Delete Failed - Group Not Found

Symptom: deleteGroup() fails with “Group not found” error.

Cause: The group GUID is incorrect or the group has already been deleted.

Solution: Verify the GUID is correct and the group still exists by fetching it first using retrieve-groups.

---

Next Steps

Leave Group

Leave groups without deleting them

Update Group

Modify group details instead of deleting

Transfer Ownership

Transfer admin rights to another member

Create Group

Create a new group