---
title: "Updates an envelope lock."
method: PUT
path: "/v2.1/accounts/{accountId}/envelopes/{envelopeId}/lock"
tags: ["EnvelopeLocks"]
---

# Updates an envelope lock.

`PUT /v2.1/accounts/{accountId}/envelopes/{envelopeId}/lock`

Updates the lock information for a locked envelope.

You must include the `X-DocuSign-Edit` header
as described in
[EnvelopeLocks: create](/docs/esign-rest-api/reference/envelopes/envelopelocks/create/).


Use this method to change the duration
of the lock (`lockDurationInSeconds`)
or the `lockedByApp` string.

The request body is a full `lockRequest` object,
but you only need to specify the
properties that you are updating. For example:

```
{
  "lockDurationInSeconds": "3600",
  "lockedByApp": "My Application"
}
```

## Path parameters

- `accountId` string, required
- `envelopeId` string, required

## Request body

- LockRequest — This request object contains information about the lock that you want to create or update.
  - `lockDurationInSeconds` string — The number of seconds to lock the envelope for editing. Must be greater than 0 seconds.
  - `lockedByApp` string — A friendly name of the application used to lock the envelope. Will be used in error messages to the user when lock conflicts occur.
  - `lockType` string — The type of lock. Currently `edit` is the only supported type.
  - `templatePassword` string — The [password for the template](https://support.docusign.com/s/document-item?bundleId=xry1643227563338&topicId=xwo1578456395432.html). If you are using a lock for a template that has a password or an envelope that is based on a template that has a password, you must enter the `templatePassword` to save the changes.
  - `useScratchPad` string — When **true,** a scratchpad is used to edit information.

## Response `200`

Successful response.

## Other responses

- `400` — Error encountered.

---

[API](https://skmtc.net/docusign/apis/docusign-esignature-rest-api.md) · [All operations](https://skmtc.net/docusign/apis/docusign-esignature-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/docusign/docusign-esignature-rest-api/versions/77f1998c313d/schema)