Complete phone change

Verifies the code (bound to the new number) and moves the account onto it — it becomes the verified number and the login username (204). The current access token stays valid; the new number takes effect at next login.

POST /api/v1/account/phone/complete

Complete phone change

cURL

curl --request POST \
  --url https://sandbox.api.nkama.ga/api/v1/account/phone/complete \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "challengeId": "<string>",
  "code": "<string>",
  "newPhoneNumber": "<string>"
}
'

Authorizations

Authorization · string · header · required

Bearer access token (JWT) issued by Keycloak or the sandbox token endpoint.

Body

application/json

challengeId · string · required

Minimum string length: 1

code · string · required

Minimum string length: 1

newPhoneNumber · string · required

Minimum string length: 1

Pattern: ^\+[1-9]\d{6,14}$

Response

204

No Content