Approve an approval request

Approve a pending approval request as the authenticated API user. The caller signs the request’s signable data with the private key of a registered approval API key and submits the base64url-encoded signature, optionally with the key ID. The server verifies the signature against the registered public key — using the given key ID, or matching against all of the user’s registered keys when the key ID is omitted — and advances the approval quorum.

Endpoint Permission: Owner, Admin, Non-Signing Admin, Approver, Signer, Security Admin.

POST

approvals

{requestId}

approve

TypeScript

const response: Promise<FireblocksResponse<void>> = fireblocks.approvalsBeta.approveApproval(approvalsBetaApiApproveApprovalRequest);

curl --request POST \
  --url https://api.fireblocks.io/v1/approvals/{requestId}/approve \
  --header 'Content-Type: application/json' \
  --data '
{
  "signature": "MEUCIQD...signature...Ok",
  "keyId": "64e6b6a3-a607-40e0-8a1e-fe93976ffd46"
}
'

const options = {
  method: 'POST',
  headers: {'Content-Type': 'application/json'},
  body: JSON.stringify({
    signature: 'MEUCIQD...signature...Ok',
    keyId: '64e6b6a3-a607-40e0-8a1e-fe93976ffd46'
  })
};

fetch('https://api.fireblocks.io/v1/approvals/{requestId}/approve', 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.fireblocks.io/v1/approvals/{requestId}/approve",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'signature' => 'MEUCIQD...signature...Ok',
    'keyId' => '64e6b6a3-a607-40e0-8a1e-fe93976ffd46'
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json"
  ],
]);

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

curl_close($curl);

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

package main

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

func main() {

	url := "https://api.fireblocks.io/v1/approvals/{requestId}/approve"

	payload := strings.NewReader("{\n  \"signature\": \"MEUCIQD...signature...Ok\",\n  \"keyId\": \"64e6b6a3-a607-40e0-8a1e-fe93976ffd46\"\n}")

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

	req.Header.Add("Content-Type", "application/json")

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

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

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.fireblocks.io/v1/approvals/{requestId}/approve")

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

request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n  \"signature\": \"MEUCIQD...signature...Ok\",\n  \"keyId\": \"64e6b6a3-a607-40e0-8a1e-fe93976ffd46\"\n}"

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

{
  "message": "<string>",
  "code": 123
}

Headers

Idempotency-Key

string

A unique identifier for the request. If the request is sent multiple times with the same idempotency key, the server will return the same response as the first request. The idempotency key is valid for 24 hours.

Path Parameters

requestId

string

required

The approval request ID.

Body

application/json

The signed approval of a pending request.

signature

string

required

Base64url-encoded signature over the request's signable data, produced with the private key of a registered approval API key. If keyId is provided the signature must match that key; otherwise it is matched against all of the user's registered keys.

Example:

"MEUCIQD...signature...Ok"

keyId

string

The ID of the approval API key used to sign the request. Optional — if omitted, the signature is verified against all of the user's registered approval API keys.

Example:

"64e6b6a3-a607-40e0-8a1e-fe93976ffd46"

Response

The approval request was approved.

⌘I

TypeScript

const response: Promise<FireblocksResponse<void>> = fireblocks.approvalsBeta.approveApproval(approvalsBetaApiApproveApprovalRequest);

curl --request POST \
  --url https://api.fireblocks.io/v1/approvals/{requestId}/approve \
  --header 'Content-Type: application/json' \
  --data '
{
  "signature": "MEUCIQD...signature...Ok",
  "keyId": "64e6b6a3-a607-40e0-8a1e-fe93976ffd46"
}
'

const options = {
  method: 'POST',
  headers: {'Content-Type': 'application/json'},
  body: JSON.stringify({
    signature: 'MEUCIQD...signature...Ok',
    keyId: '64e6b6a3-a607-40e0-8a1e-fe93976ffd46'
  })
};

fetch('https://api.fireblocks.io/v1/approvals/{requestId}/approve', 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.fireblocks.io/v1/approvals/{requestId}/approve",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'signature' => 'MEUCIQD...signature...Ok',
    'keyId' => '64e6b6a3-a607-40e0-8a1e-fe93976ffd46'
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json"
  ],
]);

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

curl_close($curl);

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

package main

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

func main() {

	url := "https://api.fireblocks.io/v1/approvals/{requestId}/approve"

	payload := strings.NewReader("{\n  \"signature\": \"MEUCIQD...signature...Ok\",\n  \"keyId\": \"64e6b6a3-a607-40e0-8a1e-fe93976ffd46\"\n}")

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

	req.Header.Add("Content-Type", "application/json")

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

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

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.fireblocks.io/v1/approvals/{requestId}/approve")

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

request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n  \"signature\": \"MEUCIQD...signature...Ok\",\n  \"keyId\": \"64e6b6a3-a607-40e0-8a1e-fe93976ffd46\"\n}"

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

{
  "message": "<string>",
  "code": 123
}

Introduction

Errors & Statuses

Data Objects

API Endpoints

Approve an approval request

Headers

Path Parameters

Body

Response