tenancy
POST /v1/orgs/{orgId}/privacy/erasure
Ask for this organization's account to be erased (GDPR Art. 17).
Authentication
Send an API key as a bearer token. This endpoint checks no specific permission, so any key for your organisation can call it.
Where your organisation id goes
This endpoint takes your organisation id in the URL itself, as orgId. Substitute it into the path — there is no header or query parameter that will do instead.
Your organisation id is on the API keys screen in your dashboard, beside the key itself. It is the same id in every call you make.
Try it
Replace anything in angle brackets with your own values, and the key placeholder with a key from your dashboard.
curl -X POST https://api.zinndigital.com/v1/orgs/{orgId}/privacy/erasure \
-H "Authorization: Bearer zdk_live_…" \
-H "Content-Type: application/json" \
-d '{ "confirm_name": <string>, "acknowledge": <boolean> }'Signed in? The API console in your dashboard fills in your real organisation id and your own key, and runs the request against the live API so you can see the actual response. Open this endpoint in the API console
Details
Double confirmation — confirm_name must equal the organization's name exactly AND acknowledge must be true (422 otherwise) — plus a sign-in from the last five minutes (403 STEP_UP_REQUIRED). Every renewal stops now, so nothing is billed after the request. The erasure runs after the cooling-off period (14 days) unless it is cancelled: the account is closed through the ordinary closure (sites torn down, client orgs re-parented), members who belong to no other org are pseudonymised and deleted from the identity provider, and contact details and free text in every other org-scoped record are overwritten. Invoices, credit notes, payments, orders and subscriptions are tax records and are kept unaltered until retain_until (10 years after the year of the last invoice), as the law requires. An org with an unpaid balance is refused (409). A request already scheduled is returned with 200.
Parameters
| Name | Type | Required | What it is |
|---|---|---|---|
orgId (path) | Uuid | Yes | Organization ID (UUIDv7). |
Request body
| Name | Type | Required | What it is |
|---|---|---|---|
confirm_name | string | Yes | The organization's exact name, typed. |
acknowledge | boolean | Yes | Must be true — the second confirmation. |
Response
| Name | Type | Required | What it is |
|---|---|---|---|
id | Uuid | Yes | UUIDv7 identifier — sortable by creation time (docs/02 §8). |
org_id | Uuid | Yes | UUIDv7 identifier — sortable by creation time (docs/02 §8). |
kind | string<export, erasure> | Yes | — |
status | PrivacyRequestStatus | Yes | — |
created_at | string | Yes | — |
erase_after | object | Yes | Erasure only — when the cooling-off period ends and the erasure runs. |
completed_at | object | Yes | — |
cancelled_at | object | Yes | — |
expires_at | object | Yes | Export only — when the archive is deleted. |
size_bytes | integer | Yes | — |
row_count | integer | Yes | — |
table_count | integer | Yes | — |
retain_until | object | Yes | Erasure only — the last day the retained tax records are kept. |
Errors this endpoint can return
401 · 403 · 404 · 409 · 422 · 429 · 503