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 3 weeks ago
Built with Documentation.AI