APICompany group

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.

Authorization

Bearer
headerAuthorizationBearer <token>

API token generated in Distru (Settings → Distru API). Send it on every request as Authorization: Bearer YOUR_API_TOKEN.

Path Parameters

id*string

ID of the company group to delete, as returned by the list and upsert endpoints.

Response Body

No Content

Example Request
curl -X DELETE 'https://app.distru.com/public/v1/company-groups/00000000-0000-0000-0000-000000000012'
Example Response
Empty