Delete A Group

Quick Reference - Delete a group:

await CometChat.deleteGroup("GUID");

Available via: SDK | REST API

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

JavaScript
TypeScript

var GUID = "GUID";

CometChat.deleteGroup(GUID).then(
response => {
  console.log("Groups deleted successfully:", response);
}, error => {
  console.log("Group delete failed with exception:", error);
}
);  

var GUID: string = "GUID";

CometChat.deleteGroup(GUID).then(
  (response: boolean) => {
      console.log("Group deleted successfully:", response);
  }, (error: CometChat.CometChatException) => {
      console.log("Group delete failed with exception:", error);
  }
);

Response

On Success — deleteGroup() returns a boolean:

Parameter	Type	Description	Sample Value
`response`	boolean	Indicates successful deletion	`true`

The deleteGroup() method takes the following parameters:

Parameter	Description
`GUID`	The GUID of the group you would like to delete

Best Practices

Confirm before deleting

Deleting a group is irreversible — all messages, members, and metadata are permanently removed. Always prompt the user for confirmation before calling deleteGroup().

Only Admins can delete groups

The logged-in user must have Admin scope on the group. Verify the user’s scope using getGroup() before attempting deletion to provide a better UX.

Troubleshooting

deleteGroup fails with permission error

Verify the logged-in user is an Admin of the group. Owners and Moderators may not have delete permissions depending on your app configuration.

Group still appears after deletion

Ensure the deleteGroup() promise resolved successfully. If using cached data, refresh your group list after deletion to remove stale entries.

Next Steps

Create a Group

Create public, private, or password-protected groups

Retrieve Groups

Fetch group lists, search groups, and get group details

Leave a Group

Leave groups and stop receiving updates

Transfer Ownership

Transfer group ownership before leaving

​Delete a Group

​Best Practices

​Troubleshooting

​Next Steps

Create a Group

Retrieve Groups

Leave a Group

Transfer Ownership

Delete a Group

Best Practices

Troubleshooting

Next Steps