Skip to content

Errors

Cannot Delete

The envelope can't be deleted in its current status. Only completed, canceled or failed envelopes can be deleted; cancel an in_progress one first.

What Happened

The request to delete an envelope failed because the envelope’s current status does not allow it. Only completed, canceled and failed envelopes can be deleted. The detail property tells you which case applies:

  • The envelope is in_progress. Cancel it first, then delete it.
  • The envelope is processing. Wait until its status is in_progress, cancel it, then delete it.
  • 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 yet. Delete it once it is completed.

Example response

409 Conflict (application/problem+json)
{
  "type": "https://signatureapi.com/docs/v1/errors/cannot-delete",
  "title": "Could Not Delete Envelope",
  "status": 409,
  "detail": "This envelope is in_progress and can't be deleted. Only completed, canceled or failed envelopes can be deleted. Cancel the envelope first, then delete it (API: POST /v1/envelopes/eb4cf433-a8af-4161-b37b-7ef57d423e56/cancel)."
}

How to Fix

  • If the envelope is in_progress, cancel it, then send the delete request again.
  • If the envelope is processing, wait until it changes to in_progress, cancel it, then delete it.
  • If the envelope is being finalized, wait until its status is completed, then delete it. Subscribe to the envelope events to know when it completes.

  Still stuck? Contact support.