---
title: "Delete group"
method: DELETE
path: "/api/v1/groups/{group_id}"
tags: ["groups"]
---

# Delete group

`DELETE /api/v1/groups/{group_id}`

Delete a group.

Soft-deletes the group and removes all tenant associations.

RLS: Filtered to current client (ClientRLSDB).

Raises:
    GroupNotFoundError: If group doesn't exist (404)

## Path parameters

- `group_id` string, uuid, required

## Response `204`

Successful Response

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `404` — Not Found
- `422` — Validation Error

## Changes

- **2026-01-29** `5f4f08ff6556` — 1 warning, 4 info
  - removed the optional property `detail` from the response with the `422` status
  - added the optional property `errors` to the response with the `422` status
  - added the required property `code` to the response with the `422` status
  - added the required property `message` to the response with the `422` status
  - …1 more

[Change history](https://skmtc.dev/kater-ai/apis/kater-api/changes/api/v1/groups/:group_id/delete.md)

---

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