Fireblocks API Documentation
Add a new signing key
POST {{baseUrl}}/key_link/signing_keys
Adds a new signing key to the workspace. The added key will be linked to the specific Fireblocks agent user ID. The same user will receive the proof of ownership message to be signed, and upon successful proof, the key will become enabled.
Please note that this endpoint is available only for Key Link enabled workspaces.
Note:
This endpoint is currently in beta and might be subject to changes.
If you want to participate and learn more about the Fireblocks Key Link, please contact your Fireblocks Customer Success Manager or send an email to CSM@fireblocks.com.
Body
PARAM
| Key | Datatype | Required | Description |
HEADERS
| Key | Datatype | Required | Description |
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. | |
Content-Type
|
string | ||
Accept
|
string |
RESPONSES
status Created
| {
"keyId": "<string>",
"signingDeviceKeyId": "<string>",
"publicKeyPem": "<string>",
"algorithm": "<string>",
"enabled": "<boolean>",
"vaultAccountId": "<number>",
"agentUserId": "<string>",
"createdAt": "<number>"
} |
Curl
curl -X POST 'https://api.fireblocks.io/v1/key_link/signing_keys' -H 'Idempotency-Key: <string>' -H 'Content-Type: application/json' -H 'Accept: application/json' -d '{"signingDeviceKeyId":"\u003cstring\u003e","signedCertPem":"\u003cstring\u003e","agentUserId":"\u003cstring\u003e","proofOfOwnership":{"message":"\u003cstring\u003e","signature":"\u003cstring\u003e"}}'
ENDPOINTS