API reference
Erasure
Customer API: GET /erasure, POST /erasure, DELETE /erasure
Whether the account was already anonymized and whether a deletion request is scheduled (customers can cancel it until it runs).
Response 200
anonymizedAtstring | nullrequiredSet once the account was anonymized.
pendingobject | nullrequiredThe scheduled request, or null.
pending.idstringrequiredpending.contactIdstringrequiredpending.requestedBy"CUSTOMER" | "OWNER" | "AGENT"requiredpending.status"REQUESTED" | "CANCELED" | "COMPLETED" | "FAILED"requiredpending.executeAtstringrequiredWhen anonymization runs (7 days after a customer's request).
pending.canceledAtstring | nullrequiredpending.completedAtstring | nullrequiredpending.failureReasonstring | nullrequiredpending.createdAtstringrequired
curl -X GET "https://{site}/api/v1/customer/erasure" \
-H "Authorization: Bearer $KANORIO_CUSTOMER_TOKEN"Schedules anonymization 7 days from now. Until then the customer can cancel with DELETE /erasure and the site owner can cancel from the back office. When it runs, identities, name, addresses, tax IDs, passkeys, sessions, form submissions, notes and metadata are removed and sign-in is blocked; orders, invoices and consent evidence (without IP or user agent) remain because the site owner must keep financial records.
Response 200
requestobjectrequiredrequest.idstringrequiredrequest.contactIdstringrequiredrequest.requestedBy"CUSTOMER" | "OWNER" | "AGENT"requiredrequest.status"REQUESTED" | "CANCELED" | "COMPLETED" | "FAILED"requiredrequest.executeAtstringrequiredWhen anonymization runs (7 days after a customer's request).
request.canceledAtstring | nullrequiredrequest.completedAtstring | nullrequiredrequest.failureReasonstring | nullrequiredrequest.createdAtstringrequired
Errors
ERASURE_ALREADY_REQUESTED409ALREADY_ANONYMIZED409
curl -X POST "https://{site}/api/v1/customer/erasure" \
-H "Authorization: Bearer $KANORIO_CUSTOMER_TOKEN" \
-H "Content-Type: application/json" \
-d '{}'Response 200
requestobjectrequiredrequest.idstringrequiredrequest.contactIdstringrequiredrequest.requestedBy"CUSTOMER" | "OWNER" | "AGENT"requiredrequest.status"REQUESTED" | "CANCELED" | "COMPLETED" | "FAILED"requiredrequest.executeAtstringrequiredWhen anonymization runs (7 days after a customer's request).
request.canceledAtstring | nullrequiredrequest.completedAtstring | nullrequiredrequest.failureReasonstring | nullrequiredrequest.createdAtstringrequired
Errors
ERASURE_NOT_PENDING409
curl -X DELETE "https://{site}/api/v1/customer/erasure" \
-H "Authorization: Bearer $KANORIO_CUSTOMER_TOKEN"