---
title: "Delete user data by verified identifier"
method: DELETE
path: "/user-data"
tags: ["Operations"]
---

# Delete user data by verified identifier

`DELETE /user-data`

## Request

- Base URL: `https://plainrouter.com/api/v1`
- URL: `https://plainrouter.com/api/v1/user-data`
- Auth: HTTP bearer

Idempotently removes retained user data using a verified raw identifier or legacy SHA-256 digest, scoped and keyed to the authenticated workspace.

## Request body

- union
  - object
    - `identifier_type` 'email' | 'phone' | 'external_id', required
    - `identifier_hash` string, required
    - `identifier` string
  - object
    - `identifier_type` 'email' | 'phone' | 'external_id', required
    - `identifier_hash` string
    - `identifier` string, required

## Response `200`

Completed idempotent deletion request.

- object
  - `deletion_request_id` string, required
  - `duplicate` boolean, required
  - `events_updated` integer, required
  - `sessions_updated` integer, required
  - `completed_at` string, required

## Other responses

- `401`: Invalid or missing Server secret.
- `422`: Request validation failed.

---

[API](https://skmtc.dev/plainrouter/apis/plainrouter-conversion-api.md) · [All operations](https://skmtc.dev/plainrouter/apis/plainrouter-conversion-api/llms.txt) · [OpenAPI document](https://skmtc.dev/plainrouter/apis/plainrouter-conversion-api/revisions/d071d4f4f05c?raw)