Erase a principal

POST

/api/admin/erasure

Maintainer:Not configured

OperationId:admin_erase_principal

Executes the erasure act for a principal, identified by pseudonym and an opaque request reference. Repeating it with the same reference completes as a no-op with already_erased: true. Requires a system admin. Any other caller gets 404, decided before any lookup, so a refusal reveals nothing about the subject.

Request

Authorization

JWT Bearer

Add the parameter

Authorization

to Headers

Example:

Authorization: ********************

Header Params

Body Params application/jsonRequired

Examples

Responses

🟢200OK

application/json

The erasure completed (already_erased on a repeat)

Bodyapplication/json

🟠401Unauthorized

🟠403Forbidden

🟠404Record Not Found

🟠422Parameter Error

Request Example

Shell

JavaScript

Java

Swift

curl --location '/api/admin/erasure' \
--header 'X-Temper-Surface;' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "request_reference": "befa7ed4-201c-4983-ac08-b6179835da7c",
    "subject": "60edbbae-71be-4fbc-b2c1-f38d95f4b1b6"
}'

Response Example

200 - Example 1

{
    "already_erased": true,
    "blob_strikes": [
        {
            "blob_id": "8249af2f-dd23-416e-b9c4-6cb13a792190",
            "released": true
        }
    ],
    "event_id": "a7a26ff2-e851-45b6-9634-d595f45458b7",
    "redacted_hashes": [
        "string"
    ],
    "status": "completed",
    "targets": [
        {
            "outcome": "string",
            "target": "string"
        }
    ]
}

Modified at 2026-10-06 12:32:37

Update system settings

Survey a principal erasure