Skip to Content

Withdraw a sent document

You're viewing API version 2026-09, which is deprecated and stops working on October 1, 2027. To move your integration, see Upgrading to 2026-10.
POST
/api/v1/documents/{id}/withdraw

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

Authorization

headerAuthorizationBearer <token>

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

Path Parameters

id*string

Header Parameters

authorization*string

Bearer token for API authentication

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

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 Body

200

application/json
  1. response
id*string

Unique document identifier

externalId?|

Your external reference ID for this document

expiresAt?|

Date and time when the document expires

Formatdate-time
name*string

Document name/title

status*string

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

documentMeta?|

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

createdAt*string

Date and time when the document was created

Formatdate-time
updatedAt*string

Date and time when the document was last updated

Formatdate-time
completedAt?|

Date and time when all signers completed signing

Formatdate-time
Example Request
curl -X POST 'https://app.sajn.se/api/v1/documents/string/withdraw' \  -H 'authorization: string' \  -H 'Content-Type: application/json' \  -d '{}'
Example Response
{  "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?