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.
Authorizations
Personal API key, e.g. Authorization: Bearer sajn_sk_.... Not scope-limited — acts as the issuing user.
Headers
API 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 ID 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.
Makes 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.
255Path Parameters
The document ID.
Body
Body
Permanently delete a document that is already in the trash. Irreversible.
Must equal the document id in the path. Guards against an accidental purge of the wrong document.
Response
Confirmation that a document was permanently deleted.

