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 https://<domain>/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"
}
}'
curl -X PUT https://<domain>/api/vault/namespace/delete/personal-data-mapping \
-H "Authorization: Bearer <NAMESPACE_ADMIN_API_KEY>" \
-H "Content-Type: application/json; charset=utf-8" \
-d '{
"data": {
"duration": 90
}
}'
{
"data": {
"tracking_id": "9f799cb6-5315-4199-8d47-3a7ced21dd1d",
"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
| Method | Endpoint |
|---|---|
PUT | https://<domain>/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.
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.
Was this page helpful?
Last updated Mar 16, 2026
Built with Documentation.AI