WoyraDocs
Get an API key

Finish signing in with a passkey

POST/v1/auth/passkeys/login/finish

Console · Public: no credential needed

Checks the device's signature and starts a full session: a passkey requires the person to be verified on the device, so it is both factors and no code follows. A passkey made for another site is refused, which is what makes passkeys phishing-proof.

Body

FieldTypeDescription
ceremonyrequiredstring
namestringA label for a new passkey
credentialrequiredobjectThe PublicKeyCredential as JSON (credential.toJSON()), binary fields base64url.

Example

curl -X POST https://api.woyra.io/v1/auth/passkeys/login/finish \
  -H 'Content-Type: application/json' \
  -d '{
    "ceremony": "<ceremony>",
    "credential": "<credential>"
  }'

Response

200 Signed in.

FieldTypeDescription
object"session"
userUser
accountobject
account.idstring
account.namestring
account.countrystring
account.currencystringThe billing currency.
account.payment_currencystringHow the account pays: USD by card, or ETB by bank deposit credited in USD.
One of ETB, USD.
account.regionstring
One of global, ethiopia.
account.statusstring
account.project_idstring
mfaobject
mfa.enabledbooleanAn authenticator app is on.
mfa.requiredboolean
mfa.pendingboolean
mfa.passkeysintegerHow many passkeys the user has. A passkey counts as a second factor.
mfa.recovery_codesintegerUnused recovery codes left.
sessionobject
session.idstring
session.expires_attimestamp
api_keyobjectOnly on signup — the test key, with its token shown once.

Errors

StatusCodes
401authentication_required, invalid_api_key
429rate_limited, daily_send_limit_reached

Also in Console