clickup_delete_user_group
Permanently remove a stale or duplicate User Group from your ClickUp Workspace by providing its group ID. Member accounts remain unaffected.
Instructions
Permanently delete a User Group from a Workspace.
Calls DELETE /group/{group_id} (ClickUp's endpoint slug is
deleteteam, but this deletes a User Group, not the Workspace
itself — group_id is never a team_id). Deleting the group does not
delete the member accounts; members keep whatever direct or inherited
access they already had outside the group.
When to Use:
To remove a stale or duplicate User Group.
When NOT to Use:
To remove a single member while keeping the group, use
clickup_update_user_groupwithremove_member_idsinstead.
Returns: A confirmation string once the group is deleted.
Examples: params = {"group_id": "4bfdfcec-6f4f-40a7-b0d6-22660d51870d"}
Error Handling: 404 if group_id doesn't exist (it may already be deleted); 403 if the token lacks permission.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| params | Yes |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |