Update envelope

Updates the details of an existing envelope, such as adding or removing documents, modifying signers, or changing other associated metadata. Be aware that modifications to documents will not be allowed if any signer has already approved the envelope, nor will you be able to change signers who have already approved the envelope. The updated envelope will retain its unique identifier, and changes can be tracked in subsequent operations. Ensure the provided envelope ID exists and the request contains the necessary changes.

Request

Authorization

Add parameter in header

x-api-token

Example:

x-api-token: ********************

Path Params

Body Params application/json

Example

{
    "vaultId": "b5512d0f-15ec-47d8-8feb-9769429eb0ba",
    "name": "Example Envelope",
    "privateDescription": "Private description of the envelope",
    "publicDescription": "Public description of the envelope",
    "message": "Message of the envelope",
    "reviewReminder": true,
    "expiresAtUtc": "2026-01-22T00:13:38.4711465Z",
    "expirationReminder": true,
    "toBePublishedAtUtc": "2025-12-24T00:13:38.4711483Z",
    "language": "EnUs",
    "markupOrientation": "Bottom",
    "signInOrder": true,
    "isAiChatForSignersEnabled": true,
    "signers": [
        {
            "id": "79492434-910f-46ae-b224-0fda169601d7",
            "name": "John Doe",
            "email": "john.doe@example.com",
            "emailCommunicationMode": 0,
            "role": "Sign",
            "title": "Lawyer",
            "shouldEnforceEmailValidation": true,
            "shouldEnforceSmsValidation": true,
            "shouldEnforceWhatsAppValidation": true,
            "shouldEnforcePixValidation": true,
            "shouldEnforceCustomDigitalCertificateValidation": true,
            "phoneIdd": 1,
            "phoneNumber": "5555555555",
            "smsCommunicationMode": 0,
            "whatsAppCommunicationMode": 0,
            "documentType": "GenericIdentification",
            "documentValue": "1234567890",
            "shouldEnforcePasscodeValidation": true,
            "passcode": "123456",
            "passcodeHint": "1 to 6",
            "signMarks": [
                {
                    "id": "9b71880f-75e9-43c8-99cd-ac3884ecf258",
                    "type": "Rubric",
                    "documentId": "8b530b4e-313f-413e-9c55-21f8d5c48de1",
                    "page": 1,
                    "x": 150,
                    "y": 50,
                    "rotation": 0
                },
                {
                    "id": null,
                    "type": "Signature",
                    "documentId": "8b530b4e-313f-413e-9c55-21f8d5c48de1",
                    "page": 2,
                    "x": 200,
                    "y": 50,
                    "rotation": 0
                }
            ]
        }
    ],
    "documents": [
        {
            "id": "8b530b4e-313f-413e-9c55-21f8d5c48de1",
            "name": "Example Document",
            "privateDescription": "Private description of the document",
            "publicDescription": "Public description of the document",
            "language": "EnUs",
            "markupOrientation": "Bottom"
        }
    ]
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request PUT 'https://api.signater.com/v1/ecm/envelopes/' \
--header 'x-api-token: <api-key>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "vaultId": "b5512d0f-15ec-47d8-8feb-9769429eb0ba",
    "name": "Example Envelope",
    "privateDescription": "Private description of the envelope",
    "publicDescription": "Public description of the envelope",
    "message": "Message of the envelope",
    "reviewReminder": true,
    "expiresAtUtc": "2026-01-22T00:13:38.4711465Z",
    "expirationReminder": true,
    "toBePublishedAtUtc": "2025-12-24T00:13:38.4711483Z",
    "language": "EnUs",
    "markupOrientation": "Bottom",
    "signInOrder": true,
    "isAiChatForSignersEnabled": true,
    "signers": [
        {
            "id": "79492434-910f-46ae-b224-0fda169601d7",
            "name": "John Doe",
            "email": "john.doe@example.com",
            "emailCommunicationMode": 0,
            "role": "Sign",
            "title": "Lawyer",
            "shouldEnforceEmailValidation": true,
            "shouldEnforceSmsValidation": true,
            "shouldEnforceWhatsAppValidation": true,
            "shouldEnforcePixValidation": true,
            "shouldEnforceCustomDigitalCertificateValidation": true,
            "phoneIdd": 1,
            "phoneNumber": "5555555555",
            "smsCommunicationMode": 0,
            "whatsAppCommunicationMode": 0,
            "documentType": "GenericIdentification",
            "documentValue": "1234567890",
            "shouldEnforcePasscodeValidation": true,
            "passcode": "123456",
            "passcodeHint": "1 to 6",
            "signMarks": [
                {
                    "id": "9b71880f-75e9-43c8-99cd-ac3884ecf258",
                    "type": "Rubric",
                    "documentId": "8b530b4e-313f-413e-9c55-21f8d5c48de1",
                    "page": 1,
                    "x": 150,
                    "y": 50,
                    "rotation": 0
                },
                {
                    "id": null,
                    "type": "Signature",
                    "documentId": "8b530b4e-313f-413e-9c55-21f8d5c48de1",
                    "page": 2,
                    "x": 200,
                    "y": 50,
                    "rotation": 0
                }
            ]
        }
    ],
    "documents": [
        {
            "id": "8b530b4e-313f-413e-9c55-21f8d5c48de1",
            "name": "Example Document",
            "privateDescription": "Private description of the document",
            "publicDescription": "Public description of the document",
            "language": "EnUs",
            "markupOrientation": "Bottom"
        }
    ]
}'

Request

Request Code Samples

Responses