---
title: "Put a legal hold on a person's data (suspends every erasure of it), or release it"
method: PUT
path: "/api/admin/principals/{principalId}/data/legal-hold"
tags: ["data"]
---

# Put a legal hold on a person's data (suspends every erasure of it), or release it

`PUT /api/admin/principals/{principalId}/data/legal-hold`

## 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/legal-hold`
- Auth: none declared

## Path parameters

- `principalId` string, required

## Request body

- LegalHoldBody
  - `on` boolean, required
  - `reason` string

## Response `200`

The hold.

- object

## Other responses

- `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)