Delete a company

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 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.