diff --git a/spec/supabase_js_v1.yml b/spec/supabase_js_v1.yml
index 610839264df..4a702066e15 100644
--- a/spec/supabase_js_v1.yml
+++ b/spec/supabase_js_v1.yml
@@ -533,6 +533,7 @@ functions:
     notes: |
       - Requires a `service_role` key.
       - This function should only be called on a server. Never expose your `service_role` key in the browser.
+      - The `inviteUserByEmail()` method is typically used by administrators to invite users to join the application.
     examples:
       - id: basic-example
         name: Basic example.
diff --git a/spec/supabase_js_v2.yml b/spec/supabase_js_v2.yml
index f7ef0a7f609..ee3c7e5f978 100644
--- a/spec/supabase_js_v2.yml
+++ b/spec/supabase_js_v2.yml
@@ -1016,6 +1016,7 @@ functions:
     $ref: '@supabase/gotrue-js.GoTrueAdminApi.inviteUserByEmail'
     notes: |
       - Sends an invite link to the user's email address.
+      - The `inviteUserByEmail()` method is typically used by administrators to invite users to join the application.
     examples:
       - id: invite-a-user
         name: Invite a user