---
title: "Delete a group and its keywords"
method: DELETE
path: "/v1/groups/{id}"
tags: ["Groups"]
---

# Delete a group and its keywords

`DELETE /v1/groups/{id}`

## Request

- Base URL: `https://api.mentio.dev`
- URL: `https://api.mentio.dev/v1/groups/{id}`
- Auth: HTTP bearer

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.

## Path parameters

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

## Response `204`

Deleted, with its keywords

## Other responses

- `401`: Missing or invalid API key
- `404`: No such group in this workspace
- `409`: The default group cannot be deleted (default_group)

---

[API](https://skmtc.dev/mentio/apis/mentio-api.md) · [All operations](https://skmtc.dev/mentio/apis/mentio-api/llms.txt) · [OpenAPI document](https://skmtc.dev/mentio/apis/mentio-api/revisions/b16a21d0ed02?raw)