> ## Documentation Index
> Fetch the complete documentation index at: https://signatureapi-daf4ee54.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Update an envelope

> Update the label of an existing envelope

Updates an envelope by setting the values of the properties passed. Any properties not provided are left unchanged.

Currently, only the `label` property can be updated. The label is for internal use and is not shown to recipients. It can be updated regardless of the envelope's status.

## Path parameters

<ParamField path="envelope_id" type="uuid" required={true}>
  The unique identifier of the envelope, in UUID format.
</ParamField>

## Body parameters

<ParamField body="label" type="string" required={false}>
  A custom label for internal identification. Labels are not shown to recipients. Unlike `title`, which recipients see, the label is for your team's use only. It can be updated at any time via the Update Envelope endpoint.

  Maximum 500 characters. Defaults to `null`.
</ParamField>

## Returns

Returns a `200 OK` status code along with the updated [envelope object](/docs/api/resources/envelopes/object) on success, or an [error](/docs/api/errors) otherwise.

<RequestExample>
  ```json Request theme={null}
  // PATCH https://api.signatureapi.com/v1/envelopes/{envelope_id}
  // X-API-Key: key_test_...
  // Content-Type: application/json

  {
    "label": "Exploration Agreement for Order Ref. 29009"
  }
  ```
</RequestExample>

<ResponseExample>
  ```json Response theme={null}
  // HTTP Status Code 200

  {
    "id": "55072f0e-b919-4d69-89cd-e7e56af00530",
    "title": "Exploration Agreement",
    "label": "Exploration Agreement for Order Ref. 29009",
    //...
  }
  ```
</ResponseExample>