Skip to content

Errors

Cannot Cancel

The envelope can't be canceled in its current status. Cancel only in_progress envelopes; wait if it is still processing or being finalized.

What Happened

The request to cancel an envelope failed because the envelope’s current status does not allow it. The detail property tells you which case applies:

  • The envelope is completed, canceled or failed. These are final statuses, and a final envelope can’t be canceled.
  • The envelope is processing. It is not cancelable yet. Cancel it once its status is in_progress.
  • The envelope is being finalized. Every recipient has acted and SignatureAPI is producing the signed documents. The status still reads in_progress, but the envelope can’t be canceled. It completes shortly.

Example response

409 Conflict (application/problem+json)
{
  "type": "https://signatureapi.com/docs/v1/errors/cannot-cancel",
  "title": "Could Not Cancel Envelope",
  "status": 409,
  "detail": "This envelope is already completed and can't be canceled. Only envelopes that are in_progress can be canceled."
}

How to Fix

Read the envelope status in the detail property, then act on it.

  • For a final status, there is nothing to cancel. Get the envelope to confirm its status before you retry.
  • For processing, wait until the status changes to in_progress, then cancel it again.
  • If the detail says the envelope is being finalized, do not retry. The envelope moves to completed on its own. Subscribe to the envelope events to know when it does.

  Still stuck? Contact support.