diff --git a/app/controllers/api/account.php b/app/controllers/api/account.php
index 455fbcd6fa..624f9156eb 100644
--- a/app/controllers/api/account.php
+++ b/app/controllers/api/account.php
@@ -1111,7 +1111,7 @@ App::post('/v1/account/sessions/magic-url')
     });
 
 App::put('/v1/account/sessions/token')
-->desc('Exchange token for session')
+->desc('Update universal token session')
 ->groups(['api', 'account'])
     ->label('scope', 'public')
     ->label('auth.type', 'token')
@@ -1121,8 +1121,8 @@ App::put('/v1/account/sessions/token')
     ->label('usage.metric', 'sessions.{scope}.requests.create')
     ->label('sdk.auth', [])
     ->label('sdk.namespace', 'account')
-    ->label('sdk.method', 'createTokenSession')
-    ->label('sdk.description', '/docs/references/account/create-token-session.md')
+    ->label('sdk.method', 'exchangeTokenForSession')
+    ->label('sdk.description', '/docs/references/account/update-universal-token-session.md')
     ->label('sdk.response.code', Response::STATUS_CODE_CREATED)
     ->label('sdk.response.type', Response::CONTENT_TYPE_JSON)
     ->label('sdk.response.model', Response::MODEL_SESSION)
diff --git a/app/controllers/api/users.php b/app/controllers/api/users.php
index df253ed698..598233dbc3 100644
--- a/app/controllers/api/users.php
+++ b/app/controllers/api/users.php
@@ -1092,7 +1092,7 @@ App::post('/v1/users/:userId/tokens')
     ->label('sdk.auth', [APP_AUTH_TYPE_KEY])
     ->label('sdk.namespace', 'users')
     ->label('sdk.method', 'createToken')
-    ->label('sdk.description', '/docs/references/users/create-user-token.md')
+    ->label('sdk.description', '/docs/references/users/create-universal-token-session.md')
     ->label('sdk.response.code', Response::STATUS_CODE_CREATED)
     ->label('sdk.response.type', Response::CONTENT_TYPE_JSON)
     ->label('sdk.response.model', Response::MODEL_TOKEN)
diff --git a/docs/references/account/update-universal-token-session.md b/docs/references/account/update-universal-token-session.md
new file mode 100644
index 0000000000..6eba681531
--- /dev/null
+++ b/docs/references/account/update-universal-token-session.md
@@ -0,0 +1 @@
+Use this endpoint to exchange a previously generated 'universal' token for a session. The returned session will be a regular session object with all its own credentials and metadata.
\ No newline at end of file
diff --git a/docs/references/users/create-universal-token-session.md b/docs/references/users/create-universal-token-session.md
new file mode 100644
index 0000000000..c443cdd572
--- /dev/null
+++ b/docs/references/users/create-universal-token-session.md
@@ -0,0 +1 @@
+Use this endpoint to generate a 'universal' token which can be sent to a user by a secure method, and then exchanged for a session.
\ No newline at end of file