Delete template lock | Docusign

curl -X DELETE https://demo.docusign.net/restapi/v2.1/accounts/ACCOUNT_ID/templates/TEMPLATE_ID/lock \
     -H "Authorization: Bearer <apiKey>" \
     -H "Content-Type: application/json" \
     -d '{
  "lockDurationInSeconds": "sample string 1",
  "lockedByApp": "sample string 2",
  "lockType": "sample string 3",
  "templatePassword": "sample string 4",
  "useScratchPad": "sample string 5"
}'

{
  "errorDetails": {
    "errorCode": "sample string 1",
    "message": "sample string 2"
  },
  "lockDurationInSeconds": "sample string 1",
  "lockedByApp": "sample string 2",
  "lockedByUser": {
    "accountId": "sample string 1",
    "accountName": "sample string 2",
    "activationAccessCode": "sample string 3",
    "email": "sample string 4",
    "ipAddress": "sample string 5",
    "loginStatus": "sample string 6",
    "membershipId": "sample string 7",
    "sendActivationEmail": "sample string 8",
    "uri": "sample string 9",
    "userId": "sample string 10",
    "userName": "sample string 11",
    "userStatus": "sample string 12",
    "userType": "sample string 13"
  },
  "lockedUntilDateTime": "sample string 3",
  "lockToken": "sample string 4",
  "lockType": "sample string 5",
  "useScratchPad": "sample string 6"
}

Deletes the lock from the specified template. The user deleting the lock must be the same user who locked the template.

You must include the X-DocuSign-Edit header as described in TemplateLocks: create.

This method takes an optional query parameter that lets you specify whether changes made while the template was locked are kept or discarded.

Query Parameter	Description
`save_changes`	When true (the default), any changes made while the lock was active are saved. When false, any changes made while the template was locked are discarded.

Common API Tasks: Locking and unlocking envelopes

Authentication

AuthorizationBearer

OAuth 2.0 access token (JWT or auth-code grant). Sent as Authorization: Bearer <token> on every request except GET /v2.1 and GET /service_information, which are public discovery endpoints.

Path parameters

accountIdstringRequired

The external account number (int) or account ID Guid.

templateIdstringRequired

The ID of the template.

Request

This endpoint expects an object: lockRequest

lockDurationInSecondsstringOptional

The configured value is not used; the timeout is hardcoded to 600 seconds. To use a different timeout, implement a custom timer and explicitly control locking and unlocking.

lockedByAppstringOptional

A friendly name of the application used to lock the envelope. Will be used in error messages to the user when lock conflicts occur.

lockTypestringOptional

The type of lock. Currently edit is the only supported type.

templatePasswordstringOptional

The password for the template. 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.

useScratchPadstringOptional

When true, a scratchpad is used to edit information.

Response

Successful response.

errorDetailsobjectOptional

This object describes errors that occur. It is only valid for responses, and ignored in requests.

lockDurationInSecondsstringOptional

The number of seconds to lock the envelope for editing. This value must be greater than 0 seconds.

lockedByAppstringOptional

The human-readable name of the application that is locking the envelope or template. This value displays to the user in error messages when lock conflicts occur.

lockedByUserobjectOptional

lockedUntilDateTimestringOptional

The date and time that the lock expires.

lockTokenstringOptional

A unique identifier provided to the owner of the lock. You must use this token with subsequent calls to prove ownership of the lock.