Skip to main content

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 workspace
  • device: 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

OK