---
title: "Erase a person's data everywhere (identity, every org): preview, then confirm with their e-mail typed back"
method: POST
path: "/api/admin/principals/{principalId}/data/erasure"
tags: ["data"]
---

# Erase a person's data everywhere (identity, every org): preview, then confirm with their e-mail typed back

`POST /api/admin/principals/{principalId}/data/erasure`

## Request

- Base URL: `https://api.wizbi.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.wizbi.ai/api/admin/principals/{principalId}/data/erasure`
- Auth: none declared

## Path parameters

- `principalId` string, required

## Request body

- DataErasureBody
  - `confirm` boolean
  - `confirmText` string
  - `reason` string

## Response `200`

The preview.

- object

## Other responses

- `202`: The request (queued).
- `400`: Invalid, or the confirmation did not match.
- `403`: Insufficient role.
- `404`: Not found.
- `409`: Conflict, legal hold, or not ready.
- `503`: Data rights are switched off here (`data_rights_disabled`).

---

[API](https://skmtc.dev/wizbi/apis/wizbi-core-api.md) · [All operations](https://skmtc.dev/wizbi/apis/wizbi-core-api/llms.txt) · [OpenAPI document](https://skmtc.dev/wizbi/apis/wizbi-core-api/revisions/5a47416c82ec?raw)