Skip to Content
Documents

Permanently delete a document

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>

API key, e.g. Authorization: Bearer sajn_svc_.... Not scope-limited: acts with its owner's workspace role.

Path Parameters

id*string

The document ID.

Header Parameters

Sajn-Version?string

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.

Value in"2026-09""2026-10"
Sajn-Workspace?string

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.

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

The document ID.

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/cm4k2x9p10003abcd1234efgh/purge' \  -H 'Content-Type: application/json' \  -d '{  "confirmDocumentId": "cm4k2x9p10003abcd1234efgh"}'
Example Response
{  "id": "cm4k2x9p10003abcd1234efgh",  "name": "Anställningsavtal – Kai Lindqvist",  "purged": true,  "verificationRetained": false}

Was this page helpful?