Data Deletion & RetentionDelete Personal Data Mappings

Delete Personal Data Mappings

Delete stored text-to-token mappings older than a specific date or duration to enforce GDPR right-to-erasure and retention policies.

curl -X PUT {baseurl}/api/vault/namespace/delete/personal-data-mapping \
  -H "Authorization: Bearer <NAMESPACE_ADMIN_API_KEY>" \
  -H "Content-Type: application/json; charset=utf-8" \
  -d '{
    "data": {
      "date": "2023-01-01"
    }
  }'
{
  "data": [
    {
      "tracking_id": {
        "tracking_id": "9f799cb6-5315-4199-8d47-3a7ced21dd1d"
      },
      "data_deletion": {
        "status": "PENDING",
        "job_type": "data-deletion"
      }
    }
  ],
  "success": true,
  "error": { "message": "" }
}

Deletes stored text-to-token mappings from a namespace that are older than a given date or duration. Commonly used to meet GDPR, SOC 2, or internal retention policies where reversible data must not be kept indefinitely.

Endpoint

MethodEndpoint
PUT{baseurl}/api/vault/namespace/delete/personal-data-mapping

Request body

You must provide either date or duration — not both.

body
datestring

Delete mappings created before this date. Format: YYYY-MM-DD.

body
durationinteger

Delete mappings older than this many days.

data[0].tracking_id.tracking_idstring

String tracking identifier for the deletion job.

data[0].data_deletion.statusstring

String status of the deletion job, initially PENDING.

data[0].data_deletion.job_typestring

String identifying the job as a personal data deletion operation.

Notes

  • Deleting personal data mappings does not affect anonymized entities — anonymized data is irreversible and not stored as mappings
  • For large namespaces, deletion jobs may take several minutes
  • Use the Track Deletion Jobs API to monitor progress
  • Poll every 30–60 seconds; avoid aggressive polling

This operation is irreversible. Once mappings are deleted, the corresponding tokens can no longer be unmasked.