WebAuthn — Passkeys & MFA

Initiate passkey recovery for a locked-out user (root only)

Root user triggers this to send a 6-digit OTP to the locked-out user's email. Returns an otpId that the locked-out user needs for the verify-otp step.

post/api/v1/organizations/{organizationId}/webauthn/recovery/initiate

Request

  • Base URL: https://api-sandbox.koywe.com
  • URL: https://api-sandbox.koywe.com/api/v1/organizations/{organizationId}/webauthn/recovery/initiate
  • Auth: HTTP bearer

Path parameters

organizationIdstring required

Request body

targetUserIdstring required

User ID of the locked-out user

Response

otpIdstring required

OTP ID — pass this to the locked-out user for verify-otp step

targetEmailstring required

Masked email where the OTP was sent (e.g., g***@koywe.com)

Changes

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