Skip to main content
POST
/
key-stores
/
{storeId}
/
genesis
/
input
Create Genesis Input
curl --request POST \
  --url https://api.dfns.io/key-stores/{storeId}/genesis/input \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'X-DFNS-USERACTION: <api-key>' \
  --data '
{
  "kind": "Genesis",
  "numProvisioners": 3,
  "numSecp256k1": 1000,
  "numEd25519": 1000,
  "hsmGenesisSerial": "<string>",
  "macGenesisSerial": "<string>"
}
'
"<string>"

​
Authentication

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

​
Required Permissions

KeyStores:Fleets:Create: 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

​
storeId
string
required
Minimum string length: 1

Body

application/json
​
kind
enum<string>
required
Available options:
Genesis
​
numProvisioners
integer
required
Required range: 2 <= x <= 5
​
numSecp256k1
integer
required
Required range: 0 <= x <= 2000
​
numEd25519
integer
required
Required range: 0 <= x <= 2000
​
hsmGenesisSerial
string
required
Minimum string length: 1
​
macGenesisSerial
string
Minimum string length: 1
​
hsmGenesisFirmwareVersion
enum<string>
Available options:
2.2,
2.4

Response

200 - application/zip

Success

Zip archive containing input/input.json, the genesis fleet-input document.

Last modified on July 2, 2026