Register signing keys in bulk

Accepts a set of signing keys certified by a single validation key and queues them for registration in the background. Returns a job id to poll. A workspace can have one bulk registration at a time; submitting another while one is QUEUED or IN_PROGRESS is rejected with 409. Bulk registrations from different workspaces share a limited number of slots, so a job may wait QUEUED behind another workspace’s before it starts. Keys already registered in the workspace are recognized and skipped, so resubmitting the same request after a failure is safe and only processes what is missing. Every key must carry its own proof of ownership; a bulk registration has no interactive step in which one can arrive later.

POST

key_link

signing_keys

bulk

TypeScript

const response: Promise<FireblocksResponse<CreateBulkSigningKeysResponse>> = fireblocks.keyLinkBeta.createBulkSigningKeys(keyLinkBetaApiCreateBulkSigningKeysRequest);

curl --request POST \
  --url https://api.fireblocks.io/v1/key_link/signing_keys/bulk \
  --header 'Content-Type: application/json' \
  --data '
{
  "validationKeyId": "fb5d0a66-ca01-44f0-9080-8c3282964a23",
  "keys": []
}
'

const options = {
  method: 'POST',
  headers: {'Content-Type': 'application/json'},
  body: JSON.stringify({validationKeyId: 'fb5d0a66-ca01-44f0-9080-8c3282964a23', keys: []})
};

fetch('https://api.fireblocks.io/v1/key_link/signing_keys/bulk', 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/key_link/signing_keys/bulk",
  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([
    'validationKeyId' => 'fb5d0a66-ca01-44f0-9080-8c3282964a23',
    'keys' => [
        
    ]
  ]),
  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/key_link/signing_keys/bulk"

	payload := strings.NewReader("{\n  \"validationKeyId\": \"fb5d0a66-ca01-44f0-9080-8c3282964a23\",\n  \"keys\": []\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/key_link/signing_keys/bulk")

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  \"validationKeyId\": \"fb5d0a66-ca01-44f0-9080-8c3282964a23\",\n  \"keys\": []\n}"

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

{
  "jobId": "46a92767-5f93-4a46-9eed-f012196bb4fc"
}

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

{
  "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.

Body

application/json

validationKeyId

string

required

The id of the validation key that signed every certificate in this request, as returned when the validation key was registered. Not the signingDeviceKeyId of any signing key.

Maximum string length: 64

Example:

"fb5d0a66-ca01-44f0-9080-8c3282964a23"

keys

object[]

required

The signing keys to register.

Required array length: 1 - 10000 elements

Show child attributes

Example:

[]

Response

Registration is queued

jobId

string

required

Id of the registration job. Poll it for progress.

Example:

"46a92767-5f93-4a46-9eed-f012196bb4fc"

⌘I

TypeScript

const response: Promise<FireblocksResponse<CreateBulkSigningKeysResponse>> = fireblocks.keyLinkBeta.createBulkSigningKeys(keyLinkBetaApiCreateBulkSigningKeysRequest);

curl --request POST \
  --url https://api.fireblocks.io/v1/key_link/signing_keys/bulk \
  --header 'Content-Type: application/json' \
  --data '
{
  "validationKeyId": "fb5d0a66-ca01-44f0-9080-8c3282964a23",
  "keys": []
}
'

const options = {
  method: 'POST',
  headers: {'Content-Type': 'application/json'},
  body: JSON.stringify({validationKeyId: 'fb5d0a66-ca01-44f0-9080-8c3282964a23', keys: []})
};

fetch('https://api.fireblocks.io/v1/key_link/signing_keys/bulk', 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/key_link/signing_keys/bulk",
  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([
    'validationKeyId' => 'fb5d0a66-ca01-44f0-9080-8c3282964a23',
    'keys' => [
        
    ]
  ]),
  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/key_link/signing_keys/bulk"

	payload := strings.NewReader("{\n  \"validationKeyId\": \"fb5d0a66-ca01-44f0-9080-8c3282964a23\",\n  \"keys\": []\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/key_link/signing_keys/bulk")

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  \"validationKeyId\": \"fb5d0a66-ca01-44f0-9080-8c3282964a23\",\n  \"keys\": []\n}"

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

{
  "jobId": "46a92767-5f93-4a46-9eed-f012196bb4fc"
}

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

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

Introduction

Errors & Statuses

Data Objects

API Endpoints

Register signing keys in bulk

Headers

Body

Response