diff --git a/app/controllers/api/account.php b/app/controllers/api/account.php
index 3d668285db..7b6f07a7ca 100644
--- a/app/controllers/api/account.php
+++ b/app/controllers/api/account.php
@@ -1333,7 +1333,7 @@ App::post('/v1/account/sessions/token')
     ->label('abuse-limit', 10)
     ->label('abuse-key', 'ip:{ip},userId:{param-userId}')
     ->param('userId', '', new CustomId(), 'User ID.')
-    ->param('secret', '', new Text(256), 'Valid verification token.')
+    ->param('secret', '', new Text(256), 'Secret of a token generated by login methods. For example, the `createMagicURLToken` or `createPhoneToken` methods.')
     ->inject('request')
     ->inject('response')
     ->inject('user')