---
title: "Preview Delete Company"
method: POST
path: "/internal/company/delete/preview"
tags: ["internal"]
---

# Preview Delete Company

`POST /internal/company/delete/preview`

## Request

- Base URL: `https://api.kobaltlabs.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.kobaltlabs.com/internal/company/delete/preview`
- Auth: none declared

Dry run for the company purge: what will be deleted + the anchor-row decision.

## Request body `application/x-www-form-urlencoded`

- BodyPreviewDeleteCompanyInternalCompanyDeletePreviewPost
  - `company_id` string, uuid, required

## Response `200`

Successful Response

- CompanyDeletionPreview: Dry-run summary shown before the destructive confirm. `is_referenced_by_other_tenant` decides `anchor_row_action`: when another tenant's rows point at this company (as a vendor, evidence-packet requestee, review subject, …), its (disabled) `companies` row is kept so that tenant's data still resolves and isn't cascade-deleted; otherwise it is deleted outright.
  - `company_id` string, uuid, required
  - `company_name` string, required
  - `is_referenced_by_other_tenant` boolean, required
  - `referencing_companies` string[], required
  - `anchor_row_action` string, required
  - `user_count` integer, required
  - `file_count` integer, required
  - `run_count` integer, required
  - `review_count` integer, required
  - `vendor_count` integer, required
  - `s3_prefix` string, required
  - `vector_namespace` string, required

## Other responses

- `422`: Validation Error

## Changes

- **2026-09-09** `8587332d5e43`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/kobaltlabs/apis/kobaltlabs-api/changes/internal/company/delete/preview/post.md)

---

[API](https://skmtc.dev/kobaltlabs/apis/kobaltlabs-api.md) - [All operations](https://skmtc.dev/kobaltlabs/apis/kobaltlabs-api/llms.txt) - [OpenAPI document](https://skmtc.dev/kobaltlabs/apis/kobaltlabs-api/revisions/8587332d5e43?raw)