> 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

# MoveEnvelopes

MoveEnvelopes is used to move envelopes between folders.

Note: This can be used to delete envelopes by using “RecycleBin” as the FolderType. Placing an in process envelope (envelope status of sent or delivered) in the RecycleBin folder will void the envelope.

### Schema

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

| Name        | Schema Type        | Description                                                                                         |
| ----------- | ------------------ | --------------------------------------------------------------------------------------------------- |
| EnvelopeIds | Array of Envelopes | An array of EnvelopeIds for the envelopes being moved.                                              |
| AccountId   | String             | The account ID associated with the envelopes.                                                       |
| FolderFrom  | FolderTypeInfo     | The folder where the envelopes are currently located. Refer to FolderTypeInfo for more information. |
| FolderTo    | FolderTypeInfor    | The folder where the envelopes are being moved.                                                     |

This method returns MoveEnvelopeResponse with the result of the request.

#### Sample Request XML

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

<?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>
    <MoveEnvelopes xmlns="http://www.docusign.net/API/3.0">
      <Arg>
        <EnvelopeIds>
          <EnvelopeId>string</EnvelopeId>
          <EnvelopeId>string</EnvelopeId>
        </EnvelopeIds>
        <AccountId>string</AccountId>
        <FolderFrom>
          <FolderType>RecycleBin or Draft or Inbox or SentItems or Normal</FolderType>
          <FolderName>string</FolderName>
          <FolderPath>string</FolderPath>
          <FolderId>string</FolderId>
        </FolderFrom>
        <FolderTo>
          <FolderType>RecycleBin or Draft or Inbox or SentItems or Normal</FolderType>
          <FolderName>string</FolderName>
          <FolderPath>string</FolderPath>
          <FolderId>string</FolderId>
        </FolderTo>
      </Arg>
    </MoveEnvelopes>
  </soap:Body>
</soap:Envelope>
```