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
PENDINGstatus; any other status returns409 INVALID_STATE. UseDELETE /api/v1/documents/{id}for documents inDRAFT, andPOST /api/v1/approval-requests/{id}/cancelforPENDING_APPROVAL.
Permissions:
- Requires the
WITHDRAW_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
Response: Returns the document in the same shape as GET /api/v1/documents/{id}, without fields.
AuthorizationBearer <token>API key, e.g. Authorization: Bearer sajn_svc_.... Not scope-limited: acts with its owner's workspace role.
id*stringThe document ID.
Sajn-Version?stringAPI 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.
"2026-09""2026-10"Sajn-Workspace?stringID 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?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""PENDING_APPROVAL""PENDING""COMPLETED""EXPIRED""CANCELLED""REJECTED""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-timedeletedAt*|Date and time when the document moved to the trash, or null when it isn't in the trash
date-timetemplateId*|ID of the template the document was created from, or null
folderId*|ID of the folder that holds the document, or null at the top level
responsibleUserId*|ID of the workspace member responsible for the document
parties*array<>Array of document parties (signers and other participants).
tags*array<>customFields*array<>content*array<>|Content blocks in position order when you pass expand=content, and null otherwise. See the content endpoints for the per-type shapes.
productTables*array<>Every product table on the document, resolved: each row carries the recipient's final selected state and quantity, and the totals count the selected rows only. Empty when the document has no product table.
approvalRequestId*|ID of the document's approval request, or null when it has none. To read it, call GET /api/v1/approval-requests/{id}.
bundleId*|ID of the bundle the document was sent in, or null. Every document in a bundle also fires its own events, so this is the key that groups them. To read the bundle, call GET /api/v1/bundles/{id}.
curl -X POST 'https://app.sajn.se/api/v1/documents/cm4k2x9p10003abcd1234efgh/withdraw' \ -H 'Content-Type: application/json' \ -d '{ "reason": "Fel startdatum i avtalet."}'{ "id": "cm4k2x9p10003abcd1234efgh", "externalId": "HR-2026-0142", "expiresAt": "2026-10-28T22:00:00.000Z", "name": "Anställningsavtal – Kai Lindqvist", "status": "DRAFT", "documentMeta": { "subject": "Ditt anställningsavtal från Exempelbolaget AB", "message": "Hej Kai! Här är ditt anställningsavtal. Signera det med BankID senast den 28 oktober.", "signingMode": "PARALLEL", "forceReadFullDocument": false, "showChatToSigners": false, "language": "sv", "value": "540000", "redirectUrl": null, "redirectEnabled": true, "internalRecipients": [ "hr@example.com" ], "signableAfterExpired": false, "sendPlainTextEmailOnly": false, "reminderIntervalDays": 3, "allowDelegation": false, "openVerification": "PIN", "aiChatEnabled": false, "nationalIdDisplayMode": "FULL", "sameDeviceSigning": false, "documentCategoryId": "cm4k2x9p10017abcd1234efgh" }, "createdAt": "2026-09-28T09:12:00.000Z", "updatedAt": "2026-09-28T09:12:00.000Z", "completedAt": null, "deletedAt": null, "templateId": "cm4k2x9p10008abcd1234efgh", "folderId": "cm4k2x9p10011abcd1234efgh", "responsibleUserId": "cm4k2x9p10002abcd1234efgh", "parties": [ { "id": "cm4k2x9p10004abcd1234efgh", "documentId": "cm4k2x9p10003abcd1234efgh", "email": "kai@example.com", "name": "Kai Lindqvist", "phone": "+46701740605", "type": "INDIVIDUAL", "company": null, "externalId": "HR-2026-0142", "contactId": "cm4k2x9p10006abcd1234efgh", "nationalId": "191212121212", "country": "SE", "role": "SIGNER", "signingOrder": 1, "signedAt": "2026-09-29T07:41:00.000Z", "readStatus": "READ", "signingStatus": "SIGNED", "delivery": [ "EMAIL" ], "signatureMethod": "SE_BANKID", "signVerification": "PIN", "openVerification": "PIN", "sendStatus": "DELIVERED", "identityVerified": true, "identityMismatch": false, "createdAt": "2026-09-28T09:12:00.000Z" } ], "tags": [ { "id": "cm4k2x9p10010abcd1234efgh", "name": "Anställning", "color": "#16A34A" } ], "customFields": [ { "id": "cm4k2x9p10016abcd1234efgh", "name": "Startdatum", "type": "TEXT", "value": "2026-11-01" } ], "content": [ { "id": "cm4k2x9p10009abcd1234efgh", "documentId": "cm4k2x9p10003abcd1234efgh", "templateId": null, "type": "TEXT", "position": 0, "fieldMeta": { "type": "TEXT", "content": "<p>Anställningen gäller tills vidare från och med den 1 november 2026, med sex månaders provanställning.</p>" }, "createdAt": "2026-09-28T09:12:00.000Z", "updatedAt": "2026-09-28T09:12:00.000Z" } ], "productTables": [ { "fieldId": "cm4k2x9p10009abcd1234efgh", "name": "Anställningsavtal – Kai Lindqvist", "currency": "SEK", "language": "sv", "allowSelection": false, "selectionPartyId": "cm4k2x9p10004abcd1234efgh", "selectionRequired": false, "sections": [ { "id": "cm4k2x9p10037abcd1234efgh", "name": "Utbildningar", "pickOne": false } ], "rows": [ { "id": "cm4k2x9p10036abcd1234efgh", "sku": "UTB-INTRO", "name": "Introduktionsutbildning", "description": "Introduktionsutbildning.", "unit": "st", "price": 4500, "vat": 25, "billing": "ONE_TIME", "discount": { "type": "PERCENT", "value": 1 }, "optional": false, "selected": false, "quantity": 1, "lineTotal": 1, "lineNet": 1, "lineVat": 1, "sectionId": "cm4k2x9p10037abcd1234efgh", "productType": "GOODS" } ], "totals": { "subtotal": 4500, "discountAmount": 1, "vatAmount": 1125, "total": 1, "rotDeduction": 1, "rutDeduction": 1, "payable": 5625, "byBilling": { "ONE_TIME": { "subtotal": 4500, "vatAmount": 1125, "total": 1 }, "MONTHLY": { "subtotal": 4500, "vatAmount": 1125, "total": 1 }, "QUARTERLY": { "subtotal": 4500, "vatAmount": 1125, "total": 1 }, "YEARLY": { "subtotal": 4500, "vatAmount": 1125, "total": 1 } } } } ], "approvalRequestId": "cm4k2x9p10003abcd1234efgh", "bundleId": "cm4k2x9p10044abcd1234efgh"}Was this page helpful?