Delete a Group

Permanently delete a group (admin only)

Quick Reference for AI Agents & Developers

// Delete a group (admin only)
await CometChat.deleteGroup("group_guid");

// Check if user is admin first
const group = await CometChat.getGroup("group_guid");
if (group.getScope() === CometChat.GROUP_MEMBER_SCOPE.ADMIN) {
  await CometChat.deleteGroup("group_guid");
}

// Warning: Deletion is permanent - all messages and data are lost

Available via: SDK | REST API | Dashboard

Delete a group to permanently remove it and all its data.

Admin Only: Only group admins can delete groups.

Deletion is permanent - all messages and member data will be lost.

---

Delete a Group

JavaScript

const GUID = "group-123";

CometChat.deleteGroup(GUID).then(
  (response) => console.log("Group deleted:", response),
  (error) => console.log("Failed to delete:", error)
);

TypeScript

const GUID: string = "group-123";

CometChat.deleteGroup(GUID).then(
  (response: boolean) => console.log("Group deleted:", response),
  (error: CometChat.CometChatException) => console.log("Failed:", error)
);

Async/Await

const deleteGroup = async () => {
  try {
    const GUID = "group-123";
    const response = await CometChat.deleteGroup(GUID);
    console.log("Group deleted:", response);
  } catch (error) {
    console.log("Failed to delete:", error);
  }
};

---

Check Admin Status

Before attempting to delete, verify the user is an admin:

const group = await CometChat.getGroup("group-123");

if (group.getScope() === CometChat.GROUP_MEMBER_SCOPE.ADMIN) {
  // User can delete the group
  await CometChat.deleteGroup("group-123");
} else {
  console.log("Only admins can delete groups");
}

---

Best Practices

Confirmation

Always show a confirmation dialog before deleting a group to prevent accidental deletion.

Data Backup

Consider exporting important messages before deletion if needed for compliance or records.

---

Next Steps

Create Group

Create a new group

Update Group

Modify group settings