# Delete a Group

The group and its memberships. A rule that names it then names no one by it.

## Overview

- `204`, no body. The users stay; only the group and its memberships go.
- Before deleting a group your active policy set names, publish a set that no longer names it: from the deletion on, its rules name no one by it.
- `404` `GROUP_NOT_FOUND` for a group that is not yours. For `owner`, `tenantadmin`, `non_signing_admin` and `security_admin`.

## Endpoint

### `DELETE /v1/groups/{groupId}`

Authentication: bearer token required.

Deletes a group and its memberships.

**Path parameters**

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `groupId` | string (uuid) | yes | The group's id |

**Responses**

`204` Deleted

`404` Not found

```json
{
  "statusCode": 404,
  "error": "NotFoundError",
  "message": "No such group in the tenant",
  "details": { "code": "GROUP_NOT_FOUND" }
}
```

---

Web version: https://docs.aureahub.com/#group-delete