---
title: "Delete a company"
method: DELETE
path: "/public/v1/companies/{id}"
tags: ["Company"]
---

# Delete a company

`DELETE /public/v1/companies/{id}`

Deletes a company from your CRM. This is a soft delete: the company stops appearing in `GET /public/v1/companies` by default (pass the `deleted` filter as `include` or `only` to still see it) and this endpoint returns 404 for it, but the record is retained — `GET /public/v1/companies/{id}` keeps resolving it with a non-null `deleted_at`, and anything that already references the company (a sales order, purchase, invoice, or credit) keeps its reference and continues to render it. The delete cannot be undone through the API; recreating the company via upsert produces a new company with a new `id`. Responds 204 with no body on success, or 404 if no non-deleted company with that `id` exists on your account (including one that was already deleted or belongs to another account).

The delete cascades to the company's dependent CRM data, all in one atomic call: the products this company vendors and those products' batches are soft-deleted, and its [contacts](#model-contact) are soft-deleted. The company's credits are NOT deleted: they keep their applications to invoices and stay readable through the credit endpoints. Existing sales orders, purchases, and invoices for the company are also NOT deleted, and no reference ever blocks the delete. The one entry that can never be deleted is the company that represents your own business; attempting it returns a 400. No inventory is created, consumed, or released, and nothing is synced to Metrc or BioTrack. A successful delete records a `delete` entry in the company's activity log and notifies the relevant users.

Required permission: `companies_permissions_delete`.

## 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/f8930b2c2924/schema)