Security

Change the login password, set or change the security password, and turn password-recovery methods on or off.

All requests go to the gateway and need the authentication headers.

Change Password

Mutation · sso_userChangePassword

Changes the login password (change-password-dialog.tsx).

Arguments

NameTypeRequiredDescription
oldPasswordString!YesThe current password.
newPasswordString!YesThe new password. The form requires at least 8 characters, a matching confirmation, and a value different from the current one.

Variables

{
  "oldPassword": "<OLD_PASSWORD>",
  "newPassword": "<NEW_PASSWORD>"
}

Request

mutation Sso_userChangePassword($oldPassword: String!, $newPassword: String!) {
  sso_userChangePassword(oldPassword: $oldPassword, newPassword: $newPassword)
}

Response

Generated from the schema; values show field types.

{
  "data": {
    "sso_userChangePassword": "String!"
  }
}

Add Security Password

Mutation · sso_profileAddSecurityPassword

Sets a security password when the profile has none (hasSecurityPassword: false). The security password confirms sensitive actions, such as changing a verified phone number.

Arguments

NameTypeRequiredDescription
securityPasswordString!YesThe new security password. The form requires at least 6 characters and a matching confirmation.

Variables

{
  "securityPassword": "<SECURITY_PASSWORD>"
}

Request

mutation Sso_profileAddSecurityPassword($securityPassword: String!) {
  sso_profileAddSecurityPassword(securityPassword: $securityPassword)
}

Response

Generated from the schema; values show field types.

{
  "data": {
    "sso_profileAddSecurityPassword": "String!"
  }
}

Update Security Password

Mutation · sso_profileUpdateSecurityPassword

Changes an existing security password (hasSecurityPassword: true; same dialog, change-security-password-dialog.tsx).

Arguments

NameTypeRequiredDescription
oldSecurityPasswordString!YesThe current security password.
newSecurityPasswordString!YesThe new one. The form requires at least 6 characters, a matching confirmation, and a value different from the current one.

Variables

{
  "oldSecurityPassword": "<OLD_SECURITY_PASSWORD>",
  "newSecurityPassword": "<NEW_SECURITY_PASSWORD>"
}

Request

mutation Sso_profileUpdateSecurityPassword($oldSecurityPassword: String!, $newSecurityPassword: String!) {
  sso_profileUpdateSecurityPassword(
    oldSecurityPassword: $oldSecurityPassword
    newSecurityPassword: $newSecurityPassword
  )
}

Response

Generated from the schema; values show field types.

{
  "data": {
    "sso_profileUpdateSecurityPassword": "String!"
  }
}

Toggle Recovery Option

Mutation · sso_toggleProfileRecoveryOption

Turns a password-recovery method on or off. The UI uses it only for the "Recover by phone number" switch (recoveryOption: phone) and reverts the switch if the call fails. The current state is read from recoveryOptions in Get User Profile.

Arguments

NameTypeRequiredDescription
statusBoolean!Yestrue to enable, false to disable.
recoveryOptionsso_RecoveryOptionType!Yesphone | email | security_password

Variables

{
  "status": true,
  "recoveryOption": "phone"
}

Request

mutation Sso_toggleProfileRecoveryOption($status: Boolean!, $recoveryOption: sso_RecoveryOptionType!) {
  sso_toggleProfileRecoveryOption(
    status: $status
    recoveryOption: $recoveryOption
  )
}

Response

Generated from the schema; values show field types.

{
  "data": {
    "sso_toggleProfileRecoveryOption": "String!"
  }
}