Envelope Edit
Changes the expiration settings of an envelope that has already been sent. Once an envelope has been sent, its documents, recipients and fields are fixed — signatures-envelope-update applies only while the envelope is still in Draft. The expiration settings (expireInDays and alertDaysBeforeExpiry) are the only things that can still be changed, through signatures-envelope-edit.
Only expireInDays and alertDaysBeforeExpiry are read from the request body. Documents, recipients and fields are never modified by this operation.
expireInDays must be at least 2, must be at least alertDaysBeforeExpiry, and the expiry date it produces must not already be in the past — an envelope sent ten days ago cannot be given a five-day expiry.
JWT token to authenticate the request.
In: header
API key, sent as a request header.
In: header
Path Parameters
GUID of the envelope whose expiration is being changed, as returned by signatures-envelope-create in result.data.envelope.id.
uuidRequest Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
curl -X PUT "https://example.com/signatures/envelope/66e0fdcc-3b59-46e8-aef9-f55cb2cad859/edit" \ -H "Content-Type: application/json" \ -d '{ "envelope": { "expireInDays": 7, "alertDaysBeforeExpiry": 3 }, "externalContext": { "id": "12345" } }'{ "result": { "statusCode": 200, "message": "OK", "data": { "envelope": { "id": "80153442-77ac-4655-bff3-866ad6351b95", "message": "EXPIRATION_UPDATED" } } }, "origin": "PUT https://api.doctavian.com/v1/signatures/envelope/{envelopeId}/edit", "dateTime": "2026-07-20T12:00:00.000Z", "userId": "0c7cb52e-d32b-40db-b23c-99cc20525fe0", "operationId": "d48f0b7c92ae41639c05e1b8734af26d"}{ "error": { "message": "Envelope not found.", "statusCode": 400, "innerErrors": [ { "code": "ENVELOPE_ID_INVALID", "message": "Envelope not found.", "userMessage": "Envelope not found." } ] }, "origin": "PUT https://api.doctavian.com/v1/signatures/envelope/{envelopeId}/edit", "dateTime": "2026-07-20T12:00:00.000Z", "userId": "f0ec0929-b907-4cc8-add1-21ef6482385b", "operationId": "941131d65ae7d2af8b72d851a895f3e9"}{ "error": { "statusCode": 500, "message": "An unexpected error occurred while updating the expiration settings.", "innerErrors": [ { "code": "FUNCTION_EXECUTION_ERROR", "message": "An unexpected error occurred while updating the expiration settings.", "userMessage": "Something went wrong. Please try again or contact support." } ] }, "origin": "PUT https://api.doctavian.com/v1/signatures/envelope/{envelopeId}/edit", "dateTime": "2026-07-20T12:00:00.000Z", "userId": "8f3cdc32-b67d-426e-802b-7e3e11c4390e", "operationId": "44baff9d61df96be55117104f70ad223"}