Kanorio

API reference

Erasure

Customer API: GET /erasure, POST /erasure, DELETE /erasure

Base URL https://{site}/api/v1/customerErrorsPagination

Whether the account was already anonymized and whether a deletion request is scheduled (customers can cancel it until it runs).

Response 200

  • anonymizedAtstring | nullrequired

    Set once the account was anonymized.

  • pendingobject | nullrequired

    The scheduled request, or null.

  • pending.idstringrequired
  • pending.contactIdstringrequired
  • pending.requestedBy"CUSTOMER" | "OWNER" | "AGENT"required
  • pending.status"REQUESTED" | "CANCELED" | "COMPLETED" | "FAILED"required
  • pending.executeAtstringrequired

    When anonymization runs (7 days after a customer's request).

  • pending.canceledAtstring | nullrequired
  • pending.completedAtstring | nullrequired
  • pending.failureReasonstring | nullrequired
  • pending.createdAtstringrequired
curlTypeScript
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

  • requestobjectrequired
  • request.idstringrequired
  • request.contactIdstringrequired
  • request.requestedBy"CUSTOMER" | "OWNER" | "AGENT"required
  • request.status"REQUESTED" | "CANCELED" | "COMPLETED" | "FAILED"required
  • request.executeAtstringrequired

    When anonymization runs (7 days after a customer's request).

  • request.canceledAtstring | nullrequired
  • request.completedAtstring | nullrequired
  • request.failureReasonstring | nullrequired
  • request.createdAtstringrequired

Errors

  • ERASURE_ALREADY_REQUESTED 409
  • ALREADY_ANONYMIZED 409
curlTypeScript
curl -X POST "https://{site}/api/v1/customer/erasure" \
  -H "Authorization: Bearer $KANORIO_CUSTOMER_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'

Response 200

  • requestobjectrequired
  • request.idstringrequired
  • request.contactIdstringrequired
  • request.requestedBy"CUSTOMER" | "OWNER" | "AGENT"required
  • request.status"REQUESTED" | "CANCELED" | "COMPLETED" | "FAILED"required
  • request.executeAtstringrequired

    When anonymization runs (7 days after a customer's request).

  • request.canceledAtstring | nullrequired
  • request.completedAtstring | nullrequired
  • request.failureReasonstring | nullrequired
  • request.createdAtstringrequired

Errors

  • ERASURE_NOT_PENDING 409
curlTypeScript
curl -X DELETE "https://{site}/api/v1/customer/erasure" \
  -H "Authorization: Bearer $KANORIO_CUSTOMER_TOKEN"