Skip to Content

Permanently delete a document

You're viewing API version 2026-09, which is deprecated and stops working on October 1, 2027. To move your integration, see Upgrading to 2026-10.
POST
/api/v1/documents/{id}/purge

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_DOCUMENT workspace permission, which is not part of the default document-permission set.
  • Requires the documents:delete scope.

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.

Authorization

headerAuthorizationBearer <token>

Personal API key, e.g. Authorization: Bearer sajn_sk_.... Not scope-limited — acts as the issuing user.

Path Parameters

id*string

Header Parameters

authorization*string

Bearer token for API authentication

Idempotency-Key?string

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.

Lengthlength <= 255

Request Body

Body

application/json
  1. body

Permanently delete a document that is already in the trash. Irreversible.

confirmDocumentId*string

Must equal the document id in the path. Guards against an accidental purge of the wrong document.

Response Body

Confirmation that a document was permanently deleted.

application/json
  1. response

Confirmation that a document was permanently deleted.

id*string
name*string
purged*true
Value intrue
verificationRetained*boolean

True when a tombstone was kept so the sealed PDF's verify link still resolves.

Example Request
curl -X POST 'https://app.sajn.se/api/v1/documents/string/purge' \  -H 'authorization: string' \  -H 'Content-Type: application/json' \  -d '{  "confirmDocumentId": "string"}'
Example Response
{  "id": "string",  "name": "string",  "purged": true,  "verificationRetained": true}

Was this page helpful?