---
title: "Delete a group"
description: "Deletes the group and all of its keywords, each as DELETE /v1/keywords/{id} would. Their mentions are deleted too, alert rules that named them are updated, and past charges stay in the usage record. Read the group first, since `stats.keywords` tells you how many keywords will be deleted. Only non-default groups can be deleted."
canonical: https://docs.rumoro.dev/api/groups/delete-group
markdown: https://docs.rumoro.dev/api/groups/delete-group.mdx
---

# Delete a group

`DELETE /v1/groups/{id}`

Deletes the group and all of its keywords, each as DELETE /v1/keywords/{id} would. Their mentions are deleted too, alert rules that named them are updated, and past charges stay in the usage record. Read the group first, since `stats.keywords` tells you how many keywords will be deleted. Only non-default groups can be deleted.

## Parameters

| Name | In | Description |
| --- | --- | --- |
| `id` | path, required | The group's id (grp_...). |

## Responses

| Status | Meaning |
| --- | --- |
| 204 | The group and its keywords were removed |
| 401 | The API key is missing or not valid |
| 404 | This workspace has no group with this id |
| 409 | Deleting the default group is not allowed (default_group) |

The [OpenAPI document](https://api.rumoro.dev/v1/openapi.json) has every schema. Rules shared by all endpoints are in [Conventions](https://docs.rumoro.dev/conventions.mdx).