Change Player Name
horizon_change_nameChanges the authenticated player's display name to a confirmed new name using user ID and session token, returning auth status to confirm the change.
Instructions
Changes the authenticated player's display name using the matching user ID and current session. Use when: the player explicitly confirms a new display name. Not for: changing another player or account metadata. Use horizon_check_auth when session validity is uncertain. Side effects: replaces the player's current display name, with the same session validation and idle-time renewal as check-auth. Returns: AuthStatusResponse with isAuthenticated, authStatus and message. Check the response status/message to confirm the change. Errors: 400 for a blank or over-50-character name. Invalid sessions return 200 with isAuthenticated=false and INVALID_CREDENTIALS; they do not update the name. 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": {
"userId": "<userId>",
"sessionToken": "<sessionToken>",
"newName": "<newName>"
},
"name": "horizon_change_name"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| userId | Yes | Player user ID (UUID) from the result of horizon_signup_* or horizon_signin_* | |
| newName | Yes | New display name confirmed by the player, from 1 to 50 characters | |
| sessionToken | Yes | Player accessToken from signup, signin or refresh-session, passed as sessionToken (max 256 characters) |