deleteGroup( )
Deletes a group.
Description
The deleteGroup()
function returns a Promise that resolves to the deleted group after it has successfully been deleted.
Only site admins and group admins can delete their group. After the group is deleted, it is removed from both your site and the site's Dashboard.
Note: If the
suppressAuth
option is set totrue
, all permissions are overwritten, and all site members (including non-group members) can delete a group.
Syntax
function deleteGroup(groupId: string, [options: Options]): Promise<Group>
deleteGroup Parameters
NAME
TYPE
DESCRIPTION
ID of group to delete.
Authorization options.
Returns
Return Type:
NAME
TYPE
DESCRIPTION
Group ID.
Group name.
Part of a group's URL, for example, 'https:/example.com/groups/{my-group-slug}'
. Generally based on the group name, but for secret groups it is
an autogenerated string of characters, for example, 'https:/example.com/groups/{5D3yTX}'
. It is case-sensitive.
Group description.
Group privacy level. One of:
PUBLIC
: Site visitors can see the group and its content in the list of groups. Site members can join the group.PRIVATE
: Site visitors can see the group in the list of groups, but only group members can see its content. Site members can request to join the group.SECRET
: Only group members can see the group and its content in the list of groups. Site members can only join if invited by group admins, or other group members.
Group cover image.
What group members are called. For example, 'Coworkers', 'Friends', or 'Students'.
Number of members in the group.
Group settings.
Date and time the group was last active. For example, a post or comment.
Date and time the group was created.
Date and time the group was last updated.
Site member ID of the group creator. Defaults to group creator.
Was this helpful?
Delete a group
1import { Permissions, webMethod } from 'wix-web-module';2import { groups } from 'wix-groups-backend';34// Sample groupId value:5// 'fc3df3c1-36b2-4279-8be1-8e72a05a88c8'6//7// Sample options value:8// {9// suppressAuth: true10// }1112export const myCreateGroupFunction = webMethod(Permissions.Anyone, (groupId, options) => {13 return groups.deleteGroup(groupId, options)14 .then((deletedGroup) => {15 return deletedGroup;16 })17 .catch((error) => {18 console.error(error);19 });20});2122/* Promise resolves to:23 * {24 * "_id": "fc3df3c1-36b2-4279-8be1-8e72a05a88c8"25 * "name": "My Group 1"26 * "slug": "my-group-1"27 * "description": "Welcome to the group! You can connect with other members, get updates and share videos."28 * "privacyStatus": "PUBLIC"29 * "coverImage": {30 * "imageUrl": "wix:image://v1/3aa9074e348009011fa9f2d2981a~mv2.jpg/kite.jpg#originWidth=827&originHeight=445",31 * "position": {32 * "x": 160,33 * "y": 1334 * }35 * }36 * "memberTitle": "Members"37 * "memberCount": 2038 * "settings": {39 * "groupUpdatePostEnabled": true40 * "membersCanApprove": false41 * "membersCanInvite": true42 * "showMemberList": true43 * "welcomeMemberPostEnabled": true44 * }45 * "lastActivityDate": "Sun Sep 26 2021 08:23:23 GMT+0300"46 * "_createdDate": "Tues January 22 2020 12:56:02 GMT+0300"47 * "_updatedDate": "Fri October 2 2021 04:56:22 GMT+0300"48 * "owner": "9ne8e9e1-d050-4c86-9684-e7f231600a34"49 * }50 */