Deleting User Groups

Prerequisites

• Permission: data:user_group:delete

• You must be the creator of the group (only the creator can delete it)

API Endpoint

DELETE /groups?identifier={group_identifier}

Query Parameters

• identifier (required): Group UUID to delete

Response

{
  "ok": true
}

Example: Using cURL

curl -X DELETE "https://api.example.com/groups?identifier=550e8400-e29b-41d4-a716-446655440000" \
  -H "Authorization: Bearer YOUR_TOKEN"

Notes

• Deleting a group removes all group memberships (users are removed from the group)

• Users lose roles that were only assigned through this group

• The operation is permanent and cannot be undone

• Only the group creator can delete the group

• All associated role assignments are removed