---
title: "Delete a company group"
method: DELETE
path: "/public/v1/company-groups/{id}"
tags: ["CompanyGroup"]
---

# Delete a company group

`DELETE /public/v1/company-groups/{id}`

Permanently deletes a company group. This is a hard delete: the group is removed and cannot be
recovered — there is no soft-delete or undo. Returns 404 if no group with that ID belongs to the
authenticated company.

Deleting a group also strips it from any price tier that targeted or excluded companies by this
group: those price tiers keep working but lose this group from their include/exclude filters. The
group is only a label, so deleting it does not delete any customer or vendor relationship that was
tagged with it — those companies simply lose the tag.

Required permission: `settings_permissions_company_relationship_groups`.

## Path parameters

- `id` string, required

## Response `204`

No Content

## Other responses

- `400` — Invalid parameters
- `401` — Missing or invalid API token
- `403` — The API token lacks the required permission
- `404` — Not Found

---

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