Documents
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
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
POST
Withdraw a sent document
Authorizations
Headers
Body
application/json
Body
Response
200
Withdraw a sent document

