Skip to main content
POST
Permanently delete a document

Authorizations

Authorization
string
header
required

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

Headers

Sajn-Version
enum<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.

Available options:
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.

Maximum string length: 255

Path Parameters

id
string
required

The document ID.

Body

application/json

Body

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

confirmDocumentId
string
required

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.

Confirmation that a document was permanently deleted.

id
string
required

The document ID.

name
string
required
purged
enum<boolean>
required
Available options:
true
verificationRetained
boolean
required

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