Create Erasure Job
POST/api/v1/account/privacy/erasure
Create a privacy data erasure job (GDPR compliance).
This endpoint allows workspace owners and admins to delete location and event data for GDPR Article 17 (Right to be Forgotten) compliance.
Authentication: JWT token required Authorization: Owner or Admin role only
Scope Options:
workspace: Delete all data for the workspacedevice: Delete data for specific devices (requires device_ids)date_range: Delete data within a time range (requires from_date and to_date)tag: Delete data with specific tags (requires tags)
Dry Run Mode:
Set dry_run: true to estimate deletions without actually deleting data.
Always run dry-run first to verify the scope.
Example:
{
"scope": "device",
"device_ids": ["truck-005", "truck-009"],
"from_date": "2024-01-01T00:00:00Z",
"to_date": "2024-12-31T23:59:59Z",
"dry_run": true
}
PRD Reference: §4.5 Privacy Erasure API Roadmap: Phase 2, Task 2.1
Request
Responses
- 200
- 400
- 403
OK
Bad Request
Forbidden