---
title: "Delete user group"
method: DELETE
path: "/v1/user-groups/{group-id}"
tags: ["User Groups"]
---

# Delete user group

`DELETE /v1/user-groups/{group-id}`

Delete a user group. The "Everyone" group (ID 1073741824) cannot be deleted.

## Path parameters

- `group-id` integer, required

## Response `204`

User group deleted successfully

## Other responses

- `400` — Invalid group ID or attempt to delete Everyone group
- `401` — Unauthorized
- `403` — User does not have MANAGE_USERS access right
- `404` — User group not found
- `500` — Database failure

---

[API](https://skmtc.net/netxms/apis/netxms-api.md) · [All operations](https://skmtc.net/netxms/apis/netxms-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/netxms/netxms-api/versions/ee1f54ee3abd/schema)