---
title: "Delete a group and its keywords"
description: "Deletes the group and EVERY keyword in it, each the way DELETE /v1/keywords/{id} does (its mentions go with it, alert rules that named it are adjusted; charges already made stay on the usage record). Read the group first: `stats.keywords` says how many go. The default group cannot be deleted: move or delete its keywords instead."
canonical: https://docs.mentio.dev/api/groups/delete-group
markdown: https://docs.mentio.dev/api/groups/delete-group.mdx
---

# Delete a group and its keywords

`DELETE /v1/groups/{id}`

Deletes the group and EVERY keyword in it, each the way DELETE /v1/keywords/{id} does (its mentions go with it, alert rules that named it are adjusted; charges already made stay on the usage record). Read the group first: `stats.keywords` says how many go. The default group cannot be deleted: move or delete its keywords instead.

## Parameters

- `id` (path, required): Group id (grp_...).

## Responses

- 204: Deleted, with its keywords
- 401: Missing or invalid API key
- 404: No such group in this workspace
- 409: The default group cannot be deleted (default_group)

Full schemas: https://api.mentio.dev/v1/openapi.json. Conventions: https://docs.mentio.dev/conventions.mdx