Skip to main content
PUT
Registers the X25519 public key that trusset-kyc keygen prints as the record key of your instance. Every KYC source seals its records to this key, and only the private half in your tool’s keystore opens them. See Sealed KYC records. Register the key before you add a source: Add KYC Source is refused with RECIPIENT_KEY_NOT_SET without one.

Replacing the key

Sending a different key replaces the one in use, which is kept in history with its retiredAt. Sending the key already in use changes nothing.
After a replacement every source still holds an invite that pins the old key. A delivery sealed to the old key is refused with 409 RECIPIENT_KEY_MISMATCH. Issue a new invite for each source with Reissue Source Invite. sourcesToReinvite counts them.Records already waiting stay sealed to the old key. Keep the old private key in the keystore until they are opened. trusset-kyc keygen adds a key and keeps the earlier ones for this reason.
A key that was registered and replaced cannot be registered again. Create a new key instead.

Body Parameters

string
required
The 32-byte X25519 public key as 64 hex characters, with or without a 0x prefix. It is stored lowercased and unprefixed. The all-zero key is refused.

Response Fields

object
A change is written to the customer audit log as KYC_RECIPIENT_KEY_SET, with the new key ID and the one it replaced.

Error Codes