Key Link

Add a new validation key

Adds a new validation key used to validate signing keys. The new validation key will undergo an approval process by the workspace quorum.

post/key_link/validation_keys

Request

Headers

Idempotency-Keystring

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.

Request body

publicKeyPemstring required

The PEM encoded public key of the validation key being added

daysTillExpirednumber required

The number of days from the date the validation key was added until it expires

Example request

{
  "publicKeyPem": "-----BEGIN PUBLIC KEY ...  END PUBLIC KEY-----",
  "daysTillExpired": 365
}

Response

The validation key that was added and is pending approval.

adminsstring[] required

Admins who have to approve the validation key addition

approvalThresholdnumber required

Minimal number of approvers required. 0 for all

requestIdnumber required

Approval request id. Can be cancelled

Example response

{
  "validationKey": {
    "keyId": "46a92767-5f93-4a46-9eed-f012196bb4fc",
    "publicKeyPem": "-----BEGIN PUBLIC KEY ...  END PUBLIC KEY-----",
    "daysTillExpired": 365,
    "createdAt": 12345633,
    "expirationTime": 17098568
  },
  "requestId": 1234
}

Changes

No recorded changes to this operation across all 1 revision of this API.