diff --git a/apps/emqx_authn/src/emqx_authn_api.erl b/apps/emqx_authn/src/emqx_authn_api.erl
index faad2fcd8..1b02d37ae 100644
--- a/apps/emqx_authn/src/emqx_authn_api.erl
+++ b/apps/emqx_authn/src/emqx_authn_api.erl
@@ -886,6 +886,15 @@ list_users_api_spec2() ->
     Spec = list_users_api_spec(),
     Spec#{
         parameters => [
+            #{
+                name => id,
+                in => path,
+                description => <<"Authenticator id">>,
+                schema => #{
+                    type => string
+                },
+                required => true
+            },
             #{
                 name => listener_id,
                 in => path,
@@ -896,13 +905,22 @@ list_users_api_spec2() ->
                 required => true
             },
             #{
-                name => id,
-                in => path,
-                description => <<"Authenticator id">>,
+                name => page,
+                in => query,
+                description => <<"Page Index">>,
                 schema => #{
-                    type => string
+                    type => integer
                 },
-                required => true
+                required => false
+            },
+            #{
+                name => limit,
+                in => query,
+                description => <<"Page limit">>,
+                schema => #{
+                    type => integer
+                },
+                required => false
             }
         ]
     }.