---
title: "Delete Tag Group"
method: DELETE
path: "/tag-groups"
tags: ["Project"]
---

# Delete Tag Group

`DELETE /tag-groups`

Delete a user-defined tag group. By default the tags are kept and simply ungrouped (their `group` becomes null); pass delete_tags=true to delete the tags themselves and detach them from every prompt. System groups (branding/intentType) cannot be deleted.

## Request body

- object
  - `group` string, required — The group name to delete
  - `delete_tags` boolean — When true, the group's tags are deleted (and removed from all prompts) instead of just being ungrouped. Defaults to false.

## Response `200`

Group deleted successfully. By default its tags are kept and ungrouped; with delete_tags=true they are deleted.

- object — Group deleted successfully. By default its tags are kept and ungrouped; with delete_tags=true they are deleted.
  - `tag_count` number, required

## Other responses

- `404` — Response for status 404

---

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