diff --git a/methods/auth/auth.teams.list.json b/methods/auth/auth.teams.list.json
index c049d106..d3c408b9 100644
--- a/methods/auth/auth.teams.list.json
+++ b/methods/auth/auth.teams.list.json
@@ -2,7 +2,7 @@
   "group": "auth",
   "name": "auth.teams.list",
   "deprecated": false,
-  "desc": "List the workspaces a token can access.",
+  "desc": "Obtain a full list of workspaces your org-wide app has been approved for.",
   "args": {
     "cursor": {
       "required": false,
diff --git a/methods/usergroups/usergroups.users.update.json b/methods/usergroups/usergroups.users.update.json
index cf0cf5ce..cbbd0b53 100644
--- a/methods/usergroups/usergroups.users.update.json
+++ b/methods/usergroups/usergroups.users.update.json
@@ -40,7 +40,7 @@
     "failed_for_some_users": "User(s) are not in the workspace where this usergroup exists.",
     "missing_argument": "A required argument is missing.",
     "no_users_provided": "Either the users field wasn't provided or an empty value was passed.",
-    "permission_denied": "The user does not have permission to update the list of users for a User Group.",
+    "permission_denied": "The user does not have permission to update the list of users for a User Group. Check workspace settings to confirm whether the calling user has permission.",
     "plan_upgrade_required": "This workspace does not have access to User Groups, as that feature is only available on Standard and above plans.",
     "subteam_max_users_exceeded": "Exceeds maximum supported number of users per subteam.",
     "access_denied": "Access to a resource specified in the request is denied.",