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
| Name | Type | Required | Description |
|---|---|---|---|
oldPassword | String! | Yes | The current password. |
newPassword | String! | Yes | The 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
| Name | Type | Required | Description |
|---|---|---|---|
securityPassword | String! | Yes | The 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
| Name | Type | Required | Description |
|---|---|---|---|
oldSecurityPassword | String! | Yes | The current security password. |
newSecurityPassword | String! | Yes | The 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
| Name | Type | Required | Description |
|---|---|---|---|
status | Boolean! | Yes | true to enable, false to disable. |
recoveryOption | sso_RecoveryOptionType! | Yes | phone | 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!"
}
}