Update phone — step 2: re-validate liveness (if required)

View as Markdown

Re-confirms the user with a live face capture when step 1 reports that liveness re-validation is needed. Returns a new data.phoneNumberOtpRequestId that replaces the one from step 1. Skip this call when liveness is not required. Step 2 of the update-phone-number flow. Not to be confused with the identically-named forgot-password endpoints.

Authentication

ApiKeystring
Static API key issued to your tenant. Required on every request.
OR
AuthorizationBearer

End-user JWT from registration or login. Required for verification, signing, and user-scoped operations.

Request

This endpoint expects an object.
phoneNumberstringRequired
The new phone number, same value sent in step 1.
passwordstringRequired
The user's current password.
imagestringRequired

Base64-encoded face image for the liveness check.

Response

dataobject
error_codeinteger or null
error_messagestring or null
error_descriptionsstring or null