---
title: "Delete category group"
method: DELETE
path: "/api/categories/groups/{groupId}"
tags: ["Categories"]
---

# Delete category group

`DELETE /api/categories/groups/{groupId}`

Soft-deletes a custom group. The group must be empty (no active categories). System groups cannot be deleted.

## Path parameters

- `groupId` string, uuid, required

## Response `200`

Group deleted

- object
  - `success` boolean, required

## Other responses

- `401` — Unauthorized
- `403` — Subscription required
- `404` — Group not found
- `409` — Group has categories or is system-locked
- `422` — Validation failed

---

[API](https://skmtc.dev/cobaltpf/apis/cobalt-api.md) · [All operations](https://skmtc.dev/cobaltpf/apis/cobalt-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/cobaltpf/cobalt-api/revisions/8ef0dfb5d23c/schema)