Confirm a phone number change for the current identity
PATCH
/current-identity-phone
POST /current-identity-phone. Consumes the single-use, 6-digit phone-change-otp code that was sent by SMS to the requested new phone number and, on success, promotes that number from pending_auth_id to the identity's active, verified phone auth method.identity_id), not the request body. The identity must already have a phone auth method with a pending change in progress (i.e. a prior successful call to POST /current-identity-phone) — attempting to confirm without one fails with a 404.AUTH_MAX_CODE_ATTEMPTS / AUTH_CODE_LOCK_WINDOW_MS), further attempts are rejected with a 429 even if a subsequent code would have been correct — request a new code via POST /current-identity-phone to reset the flow. The code itself is single-use and time-limited; once consumed or expired it cannot be reused.Request
Body Params application/jsonRequired
Responses
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request PATCH '/current-identity-phone' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"code": "482913"
}'Response Response Example
200 - Success
{
"message": "Phone number confirmed successfully",
"status": "success",
"data": {
"phone": "+14155550132"
}
}Modified at 2026-09-30 00:29:45