Withdraw a sent document
2026-09, which is deprecated and stops working on October 1, 2027. To move your integration, see Upgrading to 2026-10.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
PENDINGorSENDINGstatus. UseDELETE /api/v1/documents/{id}for documents inDRAFT, and the approval cancel endpoint forPENDING_APPROVAL.
Permissions:
- Requires the
EDIT_DOCUMENTworkspace 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:
- Document status is set back to
DRAFT - Any existing signatures and signer verifications are removed
- Each signer's signing/sending/read status is reset
- Pending signing reminders are cancelled
- A withdrawal email is sent to every signer that had been notified
- The
document.withdrawnwebhook is triggered
AuthorizationBearer <token>Personal API key, e.g. Authorization: Bearer sajn_sk_.... Not scope-limited — acts as the issuing user.
id*stringIdempotency-Key?stringMakes 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.
length <= 255Body
application/json- body
Withdraw a sent document. Returns the document to DRAFT status, removes any signatures, and notifies signers via email.
reason?stringOptional reason for withdrawing the document. Included in notification emails to signers and the audit log.
200
application/json- response
id*stringUnique document identifier
externalId?|Your external reference ID for this document
expiresAt?|Date and time when the document expires
date-timename*stringDocument name/title
status*stringDocument status: DRAFT, SENDING, PENDING, COMPLETED, EXPIRED, CANCELLED, or IMPORTED
documentMeta?|Document metadata including subject, message, signing order, etc.
createdAt*stringDate and time when the document was created
date-timeupdatedAt*stringDate and time when the document was last updated
date-timecompletedAt?|Date and time when all signers completed signing
date-timecurl -X POST 'https://app.sajn.se/api/v1/documents/string/withdraw' \ -H 'authorization: string' \ -H 'Content-Type: application/json' \ -d '{}'{ "id": "string", "externalId": "string", "expiresAt": "2019-08-24T14:15:22Z", "name": "string", "status": "string", "documentMeta": { "subject": "string", "message": "string", "signingOrder": "PARALLEL", "forceReadFullDocument": true, "showChatToSigners": true, "preferredLanguage": "sv", "value": "string", "redirectUrl": "string", "redirectEnabled": true, "internalRecipients": [ "string" ], "signableAfterExpired": true, "sendPlainTextEmailOnly": true, "reminderIntervalDays": "string", "allowDelegation": true, "accessVerification": "NONE", "aiChatEnabled": true, "ssnDisplayMode": "FULL", "sameDeviceSigning": true, "documentCategoryId": "string" }, "createdAt": "2019-08-24T14:15:22Z", "updatedAt": "2019-08-24T14:15:22Z", "completedAt": "2019-08-24T14:15:22Z"}Was this page helpful?