---
title: "Update Envelope"
method: PATCH
path: "/sign/envelopes/{envelopeID}"
tags: ["Sign"]
---

# Update Envelope

`PATCH /sign/envelopes/{envelopeID}`

The **Update Envelope** endpoint modifies an envelope’s name, notification settings, or signing mode. All parameters are optional, so you can update any combination of these fields without affecting the others.

## Path parameters

- `envelopeID` string, uuid, required

## Request body

- EnvelopeUpdate
  - `name` string — The Envelope's name. It doesn't have to be unique. Optional field.
  - `notification` Notification
    - `subject` string, required — The subject line of the notification email.
    - `body` string, required — The body content of the notification email.
  - `mode` 'sequential' | 'parallel' — Signing mode for the envelope. Optional field.
  - `notificationsManagedBy` 'nitro' | 'sender' — Who notifies the participants of this envelope: `nitro` or `sender`. Optional field, and only available to API applications. Switching back to `nitro` requires a `notification` in the same request when the envelope has none of its own, since Nitro would otherwise have no copy to send. While an envelope is `sender` managed, a `notification` is refused: Nitro would never render it. Send the copy in the same request that hands the notifications back to `nitro`.

## Response `200`

Envelope updated successfully

- Envelope
  - `ID` string, uuid — A unique UUIDv4 string that identifies the envelope in the Nitro system.
  - `createdAt` string, date-time — UTC timestamp indicating when the envelope was created.
  - `lastModifiedAt` string, date-time — UTC timestamp indicating the last time the envelope was updated. Matches `createdAt` at the time of creation.
  - `name` string — The name of the envelope.
  - `status` 'drafted' | 'sent' | 'processing' | 'sealed' | 'rejected' | 'cancelled' | 'deleted' — The internal status of the envelope. Defaults to drafted on creation.

## Other responses

- `400` — Invalid request
- `401` — Unauthorized - Invalid or missing JWT token
- `404` — Envelope not found
- `409` — Envelope is in an invalid state for updating

## Changes

- **2026-08-24** `e6b46ba50304` — 1 info
  - added the new optional request property `notificationsManagedBy`

[Change history](https://skmtc.dev/gonitro/apis/nitro-sign-public-api/changes/sign/envelopes/:envelopeID/patch.md)

---

[API](https://skmtc.dev/gonitro/apis/nitro-sign-public-api.md) · [All operations](https://skmtc.dev/gonitro/apis/nitro-sign-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/gonitro/nitro-sign-public-api/revisions/7b97ae457833/schema)