Skip to content

Errors

Cannot Replace

The recipient can't be replaced: it has already completed, was already replaced, is an automatic signer, or the envelope is not active.

What Happened

The request to replace a recipient failed. The detail property tells you which case applies:

  • The recipient has already completed.
  • The recipient was already replaced.
  • The recipient is an automatic signer. Automatic signers can’t be replaced.
  • The envelope status is not processing or in_progress. The detail includes the envelope status.

Example response

409 Conflict (application/problem+json)
{
  "type": "https://signatureapi.com/docs/v1/errors/cannot-replace",
  "title": "Could Not Replace Recipient",
  "status": 409,
  "detail": "We can not replace the recipient because the recipient has already completed the envelope."
}

How to Fix

  • Get the recipient and the envelope, and check their statuses against the cases above.
  • If the recipient was already replaced, use the recipient that replaced it.
  • If the envelope is completed, canceled or failed, create a new envelope. A final envelope can’t change recipients.

  Still stuck? Contact support.