Reset Player Password
horizon_reset_passwordSets a player's new password using a single-use email reset token and revokes all existing sessions. Use when the player confirms their new password after requesting a reset.
Instructions
Sets a new player password with the single-use reset token received by email and revokes existing sessions. Use when: the player explicitly confirms their new password after requesting horizon_forgot_password. Not for: verification tokens (use horizon_verify_email), account discovery or automatic password changes. Side effects: consumes the reset token, replaces the password and revokes all player sessions including refresh families. Clear corresponding local credentials and use horizon_signin_email again. Returns: empty HTTP 200 represented as null; no session or password is returned. Errors: 400 for an invalid/expired reset token, an out-of-range password or a rejected common password. Obtain a fresh reset email only at the player's request. Needs HORIZON_API_KEY. Every failure returns an error result (isError) with the HTTP status and body: a 401 that horizon_test_connection also returns means HORIZON_API_KEY is wrong, 429 means the account's per-minute rate limit was reached (wait a minute, then retry).
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"token": "<token>",
"newPassword": "<newPassword>"
},
"name": "horizon_reset_password"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| token | Yes | Single-use token from the player's verification or password-reset email (max 256 characters) | |
| newPassword | Yes | New password explicitly chosen by the player, 8 to 128 characters; common passwords are rejected; never returned |