Withdraw a sent document

Withdraw (cancel) a document that has been sent out for signing. The document is returned to DRAFT status and signers are notified.

Status Requirements:

• Document must be in PENDING or SENDING status. Use DELETE /api/v1/documents/{id} for documents in DRAFT, and the approval cancel endpoint for PENDING_APPROVAL.

Permissions:

• Requires the EDIT_DOCUMENT workspace permission.

Request Body:

• reason (optional) - Free-text reason. Included in withdrawal emails to signers and stored on the audit log.

What happens when you withdraw:

1. Document status is set back to DRAFT
2. Any existing signatures and signer verifications are removed
3. Each signer’s signing/sending/read status is reset
4. Pending signing reminders are cancelled
5. A withdrawal email is sent to every signer that had been notified
6. The document.withdrawn webhook is triggered

POST /api/v1/documents/{id}/withdraw

Withdraw a sent document

cURL

curl --request POST \
  --url https://app.sajn.se/api/v1/documents/{id}/withdraw \
  --header 'Content-Type: application/json' \
  --header 'authorization: <authorization>' \
  --data '
{
  "reason": "<string>"
}
'

200

{
  "id": "<string>",
  "name": "<string>",
  "status": "<string>",
  "createdAt": "<unknown>",
  "updatedAt": "<unknown>",
  "externalId": "<string>",
  "expiresAt": "<string>",
  "documentMeta": {
    "subject": "<string>",
    "message": "<string>",
    "forceReadFullDocument": true,
    "showChatToSigners": true,
    "value": "<string>",
    "redirectUrl": "<string>",
    "redirectEnabled": true
  },
  "completedAt": "<string>"
}

Headers

authorization · string · required

Bearer token for API authentication

Path Parameters

id · string · required

Body

application/json

Body

Withdraw a sent document. Returns the document to DRAFT status, removes any signatures, and notifies signers via email.

reason · string

Optional reason for withdrawing the document. Included in notification emails to signers and the audit log.

Response

200

application/json

200

id · string · required

Unique document identifier

name · string · required

Document name/title

status · string · required

Document status: DRAFT, SENDING, PENDING, COMPLETED, EXPIRED, CANCELLED, or IMPORTED

createdAt · any · required

Date and time when the document was created

updatedAt · any · required

Date and time when the document was last updated

externalId · string | null

Your external reference ID for this document

expiresAt · string | null

Date and time when the document expires

documentMeta · object

Document metadata including subject, message, signing order, etc.

Show child attributes

completedAt · string | null

Date and time when all signers completed signing