Release Vault Lock

curl --request POST \
  --url https://api.dfns.io/vaults/{vaultId}/locks/{lockId}/release \
  --header 'Authorization: Bearer <token>' \
  --header 'X-DFNS-USERACTION: <api-key>'

import requests

url = "https://api.dfns.io/vaults/{vaultId}/locks/{lockId}/release"

headers = {
    "Authorization": "Bearer <token>",
    "X-DFNS-USERACTION": "<api-key>"
}

response = requests.post(url, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'X-DFNS-USERACTION': '<api-key>'}
};

fetch('https://api.dfns.io/vaults/{vaultId}/locks/{lockId}/release', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.dfns.io/vaults/{vaultId}/locks/{lockId}/release",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "X-DFNS-USERACTION: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.dfns.io/vaults/{vaultId}/locks/{lockId}/release"

	req, _ := http.NewRequest("POST", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("X-DFNS-USERACTION", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.dfns.io/vaults/{vaultId}/locks/{lockId}/release")
  .header("Authorization", "Bearer <token>")
  .header("X-DFNS-USERACTION", "<api-key>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.dfns.io/vaults/{vaultId}/locks/{lockId}/release")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["X-DFNS-USERACTION"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "id": "vlt-lck-0lf1e-8a8ag-2ak7vrvusrj3so0j",
  "vaultId": "<string>",
  "network": "<string>",
  "tid": "<string>",
  "amount": "<string>",
  "owner": "<string>",
  "dateCreated": "2023-11-07T05:31:56Z",
  "externalId": "<string>",
  "reason": "<string>",
  "replacesLockId": "vlt-lck-0lf1e-8a8ag-2ak7vrvusrj3so0j",
  "replacedByLockId": "vlt-lck-0lf1e-8a8ag-2ak7vrvusrj3so0j",
  "dateDeleted": "2023-11-07T05:31:56Z"
}

POST

vaults

{vaultId}

locks

{lockId}

release

Release Vault Lock

curl --request POST \
  --url https://api.dfns.io/vaults/{vaultId}/locks/{lockId}/release \
  --header 'Authorization: Bearer <token>' \
  --header 'X-DFNS-USERACTION: <api-key>'

import requests

url = "https://api.dfns.io/vaults/{vaultId}/locks/{lockId}/release"

headers = {
    "Authorization": "Bearer <token>",
    "X-DFNS-USERACTION": "<api-key>"
}

response = requests.post(url, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'X-DFNS-USERACTION': '<api-key>'}
};

fetch('https://api.dfns.io/vaults/{vaultId}/locks/{lockId}/release', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.dfns.io/vaults/{vaultId}/locks/{lockId}/release",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "X-DFNS-USERACTION: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.dfns.io/vaults/{vaultId}/locks/{lockId}/release"

	req, _ := http.NewRequest("POST", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("X-DFNS-USERACTION", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.dfns.io/vaults/{vaultId}/locks/{lockId}/release")
  .header("Authorization", "Bearer <token>")
  .header("X-DFNS-USERACTION", "<api-key>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.dfns.io/vaults/{vaultId}/locks/{lockId}/release")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["X-DFNS-USERACTION"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "id": "vlt-lck-0lf1e-8a8ag-2ak7vrvusrj3so0j",
  "vaultId": "<string>",
  "network": "<string>",
  "tid": "<string>",
  "amount": "<string>",
  "owner": "<string>",
  "dateCreated": "2023-11-07T05:31:56Z",
  "externalId": "<string>",
  "reason": "<string>",
  "replacesLockId": "vlt-lck-0lf1e-8a8ag-2ak7vrvusrj3so0j",
  "replacedByLockId": "vlt-lck-0lf1e-8a8ag-2ak7vrvusrj3so0j",
  "dateDeleted": "2023-11-07T05:31:56Z"
}

Authentication

✅ Organization User (CustomerEmployee)
❌ Delegated User (EndUser)
✅ Service Account

Required Permissions

Vaults:Locks:Release: Always required.

Authorizations

Authorization

string

header

required

Bearer Token: Used to authenticate API requests. More details how to generate the token: Authentication flows

X-DFNS-USERACTION

string

header

required

User Action Signature: Used to sign the change-inducing API requests. More details how to generate the token: User Action Signing flows

Path Parameters

vaultId

string

required

Vault id.

Required string length: 1 - 64

Pattern: ^vlt-[a-z0-9]{5}-[a-z0-9]{5}-[a-z0-9]{14,16}$

lockId

string

required

Vault lock id.

Required string length: 1 - 64

Pattern: ^vlt-lck-[a-z0-9]{5}-[a-z0-9]{5}-[a-z0-9]{14,16}$

Response

200 - application/json

Success

Vault lock object: funds manually locked for off-chain settlement or escrow.

string

required

Vault lock id.

Required string length: 1 - 64

Pattern: ^vlt-lck-[a-z0-9]{5}-[a-z0-9]{5}-[a-z0-9]{14,16}$

Example:

"vlt-lck-0lf1e-8a8ag-2ak7vrvusrj3so0j"

vaultId

string

required

network

string

required

tid

string

required

amount

string

required

owner

string

required

The user that created the lock. Only this user can update or delete it.

dateCreated

string<date-time>

required

externalId

string

reason

string

The reason or note the lock was created with.

replacesLockId

string

Set when this lock was created by an update: the lock it replaces.

Required string length: 1 - 64

Pattern: ^vlt-lck-[a-z0-9]{5}-[a-z0-9]{5}-[a-z0-9]{14,16}$

Example:

"vlt-lck-0lf1e-8a8ag-2ak7vrvusrj3so0j"

replacedByLockId

string

Set when this lock was released by an update: the lock that replaced it.

Required string length: 1 - 64

Pattern: ^vlt-lck-[a-z0-9]{5}-[a-z0-9]{5}-[a-z0-9]{14,16}$

Example:

"vlt-lck-0lf1e-8a8ag-2ak7vrvusrj3so0j"

dateDeleted

string<date-time>

Last modified on September 11, 2026

API Authorization

Identity & Access Management

Wallets & Transactions

Management

Webhooks

Release Vault Lock

Authentication

Required Permissions

Authorizations

Path Parameters

Response

​Authentication

​Required Permissions

Authorizations

Path Parameters

Response

Authentication

Required Permissions