> You are reading the Docusign Developer Documentation. For clean Markdown of any page, append .md to the page URL.
>
> Documentation indexes by section:
> - APIs and SDKs: https://docusign.docs.buildwithfern.com/docs/llms.txt
> - Platform 101: https://docusign.docs.buildwithfern.com/platform/llms.txt
> - Extension Apps: https://docusign.docs.buildwithfern.com/extension-apps/llms.txt
> - Docusign CLI: https://docusign.docs.buildwithfern.com/docusign-cli/llms.txt
>
> Authentication (OAuth, JWT Grant, M2M): https://docusign.docs.buildwithfern.com/platform/auth
> Webhooks and Connect: https://docusign.docs.buildwithfern.com/platform/webhooks
>
> OpenAPI specifications: https://docusign.docs.buildwithfern.com/openapi.json
> MCP server: https://docusign.docs.buildwithfern.com/_mcp/server

# Status and Managing Group VoidEnvelope

This section describes the method available to void envelopes. Only incomplete envelopes can be voided. VoidEnvelope method is used to void an envelope.

**`C#`**

```csharp title="C#"
// Create and send envelope as shown in linked code
DocuSignWeb.EnvelopeStatus status = <create and send envelope>;

// Void the envelope
DocuSignWeb.VoidEnvelopeStatus voidStatus = _apiClient.VoidEnvelope(status.EnvelopeID,
    "voiding reason");

// Confirm that the envelope was voided
Console.WriteLine("Voiding the envelope worked? {0}", voidStatus.VoidSuccess);
```

**`PHP`**

```php title="PHP"
// Create and send an envelope as shown in linked code
$response = <create and send envelope>;
$status = $response->CreateAndSendEnvelopeResult;

// Void the envelope
$voidEnvelopeparams = new VoidEnvelope();
$voidEnvelopeparams->EnvelopeID = $status->EnvelopeID;
$voidEnvelopeparams->Reason = "void envelope sample";
$response = $api->VoidEnvelope($voidEnvelopeparams);
```

### Schema

![](/_fern-files/_img/4df8ceb22819a085f58ee3eff9826fd1c63fdfd412f2decb30b9f409d27b4003.webp)

| Name       | Schema Type | Description                                                                                                 |
| ---------- | ----------- | ----------------------------------------------------------------------------------------------------------- |
| EnvelopeID | DSXId       | This is the envelope ID of the envelope which needs to be voided.                                           |
| Reason     | Reason      | The reason for voiding the envelope. Envelope recipients, when notified of the void, are shown this reason. |

### Sample Request XML

```
SOAPAction: "http://www.docusign.net/API/3.0/VoidEnvelope"

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Body>
    <VoidEnvelope xmlns="http://www.docusign.net/API/3.0">
      <EnvelopeID>string</EnvelopeID>
      <Reason>string</Reason>
    </VoidEnvelope>
  </soap:Body>
</soap:Envelope>
```

## VoidEnvelopeStatus

VoidEnvelopeStatus is the response method for VoidEnvelopes.

### Schema

![](/_fern-files/_img/2544450b161ed898a8f5bbd5fef72fd4401ac6248b36085a1b63ae1304ade768.webp)

| Name        | Schema Type | Description                                  |
| ----------- | ----------- | -------------------------------------------- |
| VoidSuccess | Boolean     | Set to true if the void operation succeeded. |

## Rules for VoidEnvelope

* The length of any of the EnvelopeID must not exceed 100 characters. Else, the XML validation fails and the processor throws a Validation error.
* The length of reason should not exceed 200 characters and should have a minimum of 1 character.
* EnvelopeID specified in the VoidEnvelope request should exist else an exception is thrown with error message “Envelope_Does_Not_Exist” .
* Only envelopes in the 'Sent' or 'Delivered' states may be voided. Else “Envelope_Cannot_Void_Invalid_State” exception will be thrown.
* Only the sender of envelope can void the envelope. If a user other than sender tries to void an envelope then exception “User_Not_Envelope_Sender” will be thrown.