From 8993348050cf82462c5d9f0ca22a48b8213157d8 Mon Sep 17 00:00:00 2001
From: tudor <7089284+tudddorrr@users.noreply.github.com>
Date: Tue, 24 Feb 2026 20:56:33 +0000
Subject: [PATCH] change player auth identifier docs

---
 docs/godot/player-authentication.mdx |  8 +++++++-
 docs/http/player-auth-api.mdx        | 15 +++++++++++++--
 docs/unity/player-authentication.mdx |  8 +++++++-
 3 files changed, 27 insertions(+), 4 deletions(-)

diff --git a/docs/godot/player-authentication.mdx b/docs/godot/player-authentication.mdx
index e703df5..0299ecb 100644
--- a/docs/godot/player-authentication.mdx
+++ b/docs/godot/player-authentication.mdx
@@ -152,7 +152,13 @@ else:
 
 <ScopeBadges scope='players' read write />
 
-You can also change a player's email with the `Talo.player_auth.change_email()` function - just pass in their current password and a new email.
+You can change a player's email with the `Talo.player_auth.change_email()` function - just pass in their current password and a new email.
+
+## Changing a player's identifier
+
+<ScopeBadges scope='players' read write />
+
+You can change a player's identifier with the `Talo.player_auth.change_identifier()` function - just pass in their current password and a new identifier.
 
 ## Forgotten password flow
 
diff --git a/docs/http/player-auth-api.mdx b/docs/http/player-auth-api.mdx
index 59f795c..39eae8f 100644
--- a/docs/http/player-auth-api.mdx
+++ b/docs/http/player-auth-api.mdx
@@ -41,7 +41,7 @@ To create a new session token, you will need to go through the login flow again
 
 ### `INVALID_CREDENTIALS`
 
-When authentication fails (i.e. wrong identifier or password), this error is returned. This error also occurs when trying to change a player password, trying to change an email address or toggling verification and the current password entered is incorrect.
+When authentication fails (i.e. wrong identifier or password), this error is returned. This error also occurs when changing a player password, email address, or identifier, or when toggling verification and the current password entered is incorrect.
 
 ```javascript
 {
@@ -81,7 +81,7 @@ When trying to verify a player login, this error is thrown if the `code` is not
 
 ### `IDENTIFIER_TAKEN`
 
-When trying to create a new player, this error is thrown if the `identifier` is already taken.
+When trying to create a new player or update an existing player's identifier, this error is thrown if the `identifier` is already taken.
 
 ```javascript
 {
@@ -134,6 +134,17 @@ When trying to change a player's email address, this error is thrown if the new
 }
 ```
 
+### `NEW_IDENTIFIER_MATCHES_CURRENT_IDENTIFIER`
+
+When trying to change a player's identifier, this error is thrown if the new identifier matches the current identifier.
+
+```javascript
+{
+  message: 'Please choose a different identifier',
+  errorCode: 'NEW_IDENTIFIER_MATCHES_CURRENT_IDENTIFIER'
+}
+```
+
 ### `PASSWORD_RESET_CODE_INVALID`
 
 When trying to reset a player password, this error is thrown if the reset code is incorrect or has expired.
diff --git a/docs/unity/player-authentication.mdx b/docs/unity/player-authentication.mdx
index 1e1bb18..dba9bae 100644
--- a/docs/unity/player-authentication.mdx
+++ b/docs/unity/player-authentication.mdx
@@ -206,7 +206,13 @@ catch (Exception ex)
 
 <ScopeBadges scope='players' read write />
 
-You can also change a player's email with the `Talo.PlayerAuth.ChangeEmail()` function - just pass in their current password and a new email.
+You can change a player's email with the `Talo.PlayerAuth.ChangeEmail()` function - just pass in their current password and a new email.
+
+## Changing a player's identifier
+
+<ScopeBadges scope='players' read write />
+
+You can change a player's identifier with the `Talo.PlayerAuth.ChangeIdentifier()` function - just pass in their current password and a new identifier.
 
 ## Forgotten password flow