Skip to main content

Voiding a Signing Session

This use case describes how to cancel (void) an active signing session using the EasyInk Public API.

Overview​

Voiding a session permanently cancels the signing process. This is useful when a document contains errors, terms have changed, or a participant requests cancellation.

Key Effects​

  • Irreversible: Once a session is voided, it cannot be reactivated.
  • Immediate: All active signing links for participants become invalid immediately.
  • Audit Trail: Any signatures already collected remain in the system's audit trail for compliance.
  • Status Change: The session status moves to Voided.

The Void Process​

To void a session, you must provide a reason for the cancellation.

Endpoint: POST /api/signingSessions/{id}/voided

Example: Void​

Use this for sessions where no one has signed yet, or for a normal cancellation.

Request:

{
  "reason": "The contract contains an incorrect expiration date."
}

Common Errors​

Possible error messages (for more info look at examples)

Error Message
A reason for voiding is required.
The session is already in Voided status.
The session cannot be voided due to organization policy.
The specified signing session ID was not found.

Alternatives​

If you need to fix a mistake and send a corrected version of the documents, consider using the Recreate functionality (available in the UI) instead of starting a completely new draft from scratch.