Skip to main content
POST
/
v1
/
partner
/
keys
Partner - Assign a new key with environment specification
curl --request POST \
  --url https://service.uat-keys.coincover.com/v1/partner/keys \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "user_identifier": "<string>",
  "organisation": {
    "customer_id": "<string>",
    "customer_name": "<string>"
  },
  "package": {
    "package_id": "<string>",
    "package_name": "<string>"
  }
}
'
{
  "key_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "public_key": "<string>",
  "signature": "<string>",
  "customer_id": "<string>",
  "package_id": "<string>",
  "metadata": {
    "customer_name": "<string>",
    "package_name": "<string>"
  }
}

Authorizations

​
Authorization
string
header
required

Bearer token authentication. Can be either a JWT token or API key.

Headers

​
Authorization
string
required

Bearer token for authentication. Can be either a JWT token or API key.

Body

application/json

Key assignment details with key environment specification

​
user_identifier
string
required

Unique identifier of the user

​
key_type
enum<string>
required

Type of cryptographic key to generate. rsa4096 for encryption of recovery material; secp256k1 or ed25519 for blockchain backup signers.

Available options:
rsa4096,
secp256k1,
ed25519
​
key_environment
enum<string>
required

Key environment specification - HOT (online generation) or COLD (offline generation)

Available options:
HOT,
COLD
​
organisation
object
required

Organisation metadata

​
package
object
required

Package metadata

Response

Key successfully assigned

​
key_id
string<uuid>

Unique identifier for the key

​
public_key
string

Public key in hex format

​
signature
string

Signature of the key in base64 format, produced by the generating enclave. Verify against your CoinCover verification key before encrypting recovery material.

​
customer_id
string | null

External customer identifier (e.g. organisation customer ID)

​
package_id
string | null

External package identifier (e.g. workspace/package ID)

​
metadata
object

Optional metadata describing the associated organisation and package