---
title: "Erase a person"
method: POST
path: "/v1/erasures"
tags: ["Erasures"]
---

# Erase a person

`POST /v1/erasures`

## Request

- Base URL: `https://api.sendora.se`
- URL: `https://api.sendora.se/v1/erasures`
- Auth: HTTP bearer

Erases one person's data from every server of the account, as a request under the right to erasure asks. The content of every message to or from the address, sent and received, is deleted, and the address becomes a pseudonym in the message log. The answer is the pending erasure; Sendora carries it out within a minute, and reading it by its id shows the outcome. Erasing an address again changes nothing more. It blocks nothing: later mail to or from the address is sent and received as before.

## Request body

- object
  - `address` string, email, required: The person's e-mail address.

## Response `202`

A request to erase one person's data from the account.

- object: A request to erase one person's data from the account.
  - `erasureId` string, uuid, required
  - `status` 'pending' | 'done', required: pending until Sendora has erased the person, done after.
  - `createdAt` string, date-time, required
  - `completedAt` string, date-time, nullable, required: When the erasure was done; null while pending.
  - `pseudonym` string, nullable, required: What now stands where the address was written in the message log; null while pending.
  - `messages` integer, nullable, required: Sent messages to the address whose content was deleted; null while pending.
  - `receivedMessages` integer, nullable, required: Received messages from, naming or to the address whose content was deleted; null while pending.

## Other responses

- `400`: The body, the query or a header does not match what the route takes.
- `401`: The key is missing, malformed or revoked.
- `403`: The key is of the other kind, or a connected app may not do this here: it is not for connections, the connection may only read here, or it is for test servers only.

---

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