Invalid Password Change
URI: https://docs.ankatech.co/errors/invalid-password-change
HTTP Status: 400 Bad Request
When you see this
A person changing their own password (POST /api/v3/auth/account/password/change, operation changePassword) was refused. One body answers several causes, byte for byte the same, so the response does not reveal which was true:
- the current password is wrong;
- the new password is the same as the current one, or repeats one of the last 5;
- the current password is longer than the platform verifies;
- the account cannot change its password right now: its membership is not
ACTIVE, or its tenant's state does not permit sign-in.
A new password that breaks the password policy is a different answer, Password Policy Violation, decided before the current password is checked. An account whose credential is held by an external identity provider is answered No Local Password.
The subject is always the account the access token names; the request carries no account identifier. A refusal writes nothing, and neither password appears in the response.
Common Causes
- A mistyped current password.
- A new password reused from the current one or a recent one.
- A password change attempted from an account that was disabled or suspended while its session was still live.
Response Example
{
"type": "https://docs.ankatech.co/errors/invalid-password-change",
"title": "Invalid Password Change",
"status": 400,
"detail": "The password change was refused. Check the current password and make sure the new password meets the password policy and has not been used recently.",
"instance": "/api/v3/auth/account/password/change",
"timestamp": 1763112600
}
Content-Type: application/problem+json — the response follows RFC 9457 Problem Details. The Auth API carries no correlation member in the body: correlate through the X-Correlation-Id response header. See Error Index & Overview.
How to Resolve
- Check the current password and enter it again.
- Choose a new password that differs from the current one and from the last 5.
- If the refusal persists with the right current password, the account may not be in a state that can change its password: contact your tenant administrator.
For full schema definitions, examples, and interactive testing, see the Developer Hub Reference.