Update phone number
PATCH /users/phone
PATCH
/users/phone
Updates the phone number for the authenticated user. Supports both legacy OTP flow and new MFA flow.
Legacy Flow (requestToken):
- User verifies OTP and gets requestToken
- Send requestToken in request body
- Token is validated and phone updated
MFA Flow (phoneNumber + feature flag enabled):
- Complete MFA flow: phone_update_flow with otp_email challenge
- Send phoneNumber in request body + MFA token in header
- MFA middleware validates, phone updated
Authorizations
Section titled “Authorizations ”Parameters
Section titled “ Parameters ”Header Parameters
Section titled “Header Parameters ” X-GOTU-MFA-Token
string
MFA token from completed phone_update_flow (required for MFA flow)
Request Body
Section titled “Request Body ”UpdatePhoneRequest - either phoneNumber (MFA) or requestToken (legacy)
object
phoneNumber
New MFA flow
string
+1234567890 requestToken
Legacy OTP flow
string
eyJhbGciOiJIUzI1NiJ9...Responses
Section titled “ Responses ”No Content
Bad request
object
error
string
some meaningful error messageUnauthorized
object
error
string
some meaningful error messageForbidden - MFA not completed or invalid token
object
error
string
some meaningful error messageInternal server error
object
error
string
some meaningful error message