Account

Update phone number

Updates the phone number of the current account in two steps, sending a verification code by SMS when only a phone number is supplied, and storing the number as verified when a valid code is supplied with it. Throttled per User and per phone number, since every send costs an SMS.

PUT /api/sys/v{version:apiVersion}/account/update_phone_number

Authorisation: Minimum role: USER

Request arguments

Name	Type	Source
input	DTO_user_phone_number_update	Body

Request body example

Response

Status: 200 (OK)
Type: DTO_acknowledgement

Wrapper: DTO_response_wrap

Other statuses: 400 (BadRequest), 403 (Forbidden), 429 (TooManyRequests)

Response body example

DTO_user_phone_number_update

Name	Type	ReadOnly	Description
phone_number	String		Phone number
verification_code	String		Verification code

DTO_acknowledgement

Name	Type	ReadOnly	Description
message	String		Message

Generated Aug 4, 2026 18:37