API
hardRemoveKey
Permanently delete a key record from the store.
Description
Permanently deletes a key record from the store. This operation cannot be undone and completely removes all data associated with the key, including its history and metadata. Use this when you need to completely erase a key's existence, such as for GDPR compliance, PII deletion, or cleaning up failed provisioning attempts.
Signature
hardRemoveKey(id: KeyId): Promise<Result<void>>
Parameters
- id: key identifier to delete.
Returns
Promise<Result<void>>
Behavior
- Removes record directly; sends
key.hard_removed
analytics.
Examples
Delete a key permanently:
await uk.hardRemoveKey("k_123");
console.log("Key permanently deleted");
Handle deletion errors:
const { error } = await uk.hardRemoveKey("k_456");
if (error) {
console.error("Failed to delete key:", error.message);
}