PactbasePactbase DocsDocs
API

Log a deletion

Tell Pactbase when your systems have deleted data that was due.

POST /api/v1/retention/deletions

Needs a key with Log deletions (retention:write).

Pactbase cannot delete data in your own systems. When a retention schedule's deletion falls due, it tells you: an email to the schedule's owner (else your DPO) and a retention.deletion_due webhook, once per due date. Your system, or an n8n flow, deletes what has passed its period and then logs it here. Under a schedule, this sets the next due date. Every logged deletion gets a certificate in Retention & Deletion.

POST /api/v1/retention/deletions
Authorization: Bearer pb_live_...
Content-Type: application/json

{ "schedule_id": "SCHEDULE_ID", "records_deleted": 1240, "method": "nightly purge job", "evidence": "job run 8812" }
Field
schedule_idThe schedule, from the webhook's schedule_id. Or leave it out and say what was deleted in subject
subjectWhat was deleted, for a one-off deletion
records_deleted, method, evidenceOptional. Shown on the certificate
performed_atWhen it ran (ISO 8601). Default now, never in the future

Answer 201 with { "deletion": { ... } }. A schedule on legal hold answers 409: lift the hold first.