Delete a passkey

Your users might want to delete their passkeys. You can do this using the @passlock/client and @passlock/server libraries. For deletion, we flip the order of operations, although strictly this is not required. Delete the passkey in your vault, then delete it from the user’s password manager.

Tip

You can also remove an orphaned passkey during an authentication operation. See the full passkey deletion and handling missing passkeys guides for more information.

Backend

Use the @passlock/server library to delete the passkey from your vault.

Default

import { deletePasskey } from "@passlock/server";

const result = await deletePasskey({ passkeyId, tenancyId, apiKey });

// remove the mapping between the passkey and your local user account
await unlinkPasskey(passkeyId);

console.log("passkey deleted");

Safe

import { deletePasskey } from "@passlock/server/safe";

const result = await deletePasskey({ passkeyId, tenancyId, apiKey });

if (result.success) {
  // remove the mapping between the passkey and your local user account
  await unlinkPasskey(passkeyId);

  console.log("deleted");
} else {
  console.error(result.error.message);
}

Frontend

Use the @passlock/client library to delete the passkey from the user’s device.

Default

import { deletePasskey } from "@passlock/client";

await deletePasskey({ tenancyId, passkeyId });

console.log("passkey deleted");

Safe

import { deletePasskey } from "@passlock/client/safe";

const result = await deletePasskey({ tenancyId, passkeyId });

if (result.success) {
  console.log("deleted");
} else {
  console.error(result.error.message);
  alert("Please remove your jdoe@example.com passkey");
}