Permanently delete a document
Irreversibly delete a document: database rows, uploaded files, the sealed PDF, the signing certificate and the audit trail. There is no undo and no support path to recover it.
Requirements:
- The document must already be in the trash. Call
DELETE /api/v1/documents/{id}first. - Requires the
PERMANENTLY_DELETE_DOCUMENTworkspace permission, which is not part of the default document-permission set. - Requires the
documents:deletescope.
Completed documents: allowed, and the verify link printed into the sealed PDF keeps working. It resolves to a record holding the document ID, the sealed PDF's SHA-256 and the deletion date — and no personal data. A counterparty holding the PDF can still check their copy against that hash; the PAdES signature in their file also validates on its own, without sajn.
Backups: the document is gone from the live database immediately. Encrypted database backups roll off within 7 days.
AuthorizationBearer <token>API key, e.g. Authorization: Bearer sajn_svc_.... Not scope-limited: acts with its owner's workspace role.
id*stringThe document ID.
Sajn-Version?stringAPI version for this request. Without it, the request uses the organization's default version; an organization without a default is pinned to the latest version by its first request.
"2026-09""2026-10"Sajn-Workspace?stringID of the workspace this request acts in, from GET /api/v1/workspaces. Without it, an API key acts in its default workspace. The token's user must be a member of the workspace; an OAuth token only accepts the workspace it was granted for. A workspace that doesn't exist or can't be reached returns 403 WORKSPACE_ACCESS_DENIED.
Idempotency-Key?stringMakes retries safe. A retry with the same key and the same request replays the stored response for 24 hours (header Idempotent-Replayed: true); the same key with a different request returns 400.
length <= 255Body
application/json- body
Permanently delete a document that is already in the trash. Irreversible.
confirmDocumentId*stringMust equal the document id in the path. Guards against an accidental purge of the wrong document.
Confirmation that a document was permanently deleted.
application/json- response
Confirmation that a document was permanently deleted.
id*stringThe document ID.
name*stringpurged*truetrueverificationRetained*booleanTrue when a tombstone was kept so the sealed PDF's verify link still resolves.
curl -X POST 'https://app.sajn.se/api/v1/documents/cm4k2x9p10003abcd1234efgh/purge' \ -H 'Content-Type: application/json' \ -d '{ "confirmDocumentId": "cm4k2x9p10003abcd1234efgh"}'{ "id": "cm4k2x9p10003abcd1234efgh", "name": "Anställningsavtal – Kai Lindqvist", "purged": true, "verificationRetained": false}Was this page helpful?