---
title: "Cannot Replace"
description: "The recipient can't be replaced: it has already completed, was already replaced, is an automatic signer, or the envelope is not active."
canonical: "https://signatureapi.com/docs/v1/errors/cannot-replace"
source: "https://signatureapi.com/docs/v1/errors/cannot-replace.md"
last_verified_api_version: "1.18.0"
last_modified: "2026-11-18T11:41:57Z"
---

# 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.

_Last verified against API version 1.18.0._

## What Happened

The request to [replace a recipient](https://signatureapi.com/docs/api/resources/recipients/replace) 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

```json 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](https://signatureapi.com/support).
