Permanently delete a document
2026-09, which is deprecated and stops working on October 1, 2027. To move your integration, see Upgrading to 2026-10.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>Personal API key, e.g. Authorization: Bearer sajn_sk_.... Not scope-limited — acts as the issuing user.
id*stringIdempotency-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*stringname*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/string/purge' \ -H 'authorization: string' \ -H 'Content-Type: application/json' \ -d '{ "confirmDocumentId": "string"}'{ "id": "string", "name": "string", "purged": true, "verificationRetained": true}Was this page helpful?