Rename members_count to members_count_with_descendants and expose only to group admins

1 files changed, 6 insertions, 6 deletions

diff --git a/doc/api/namespaces.md b/doc/api/namespaces.md
index d38a80176d9..8b5afe29040 100644
--- a/doc/api/namespaces.md
+++ b/doc/api/namespaces.md
@@ -30,9 +30,7 @@ Example response:
     "id": 1,
     "path": "user1",
     "kind": "user",
-    "full_path": "user1",
-    "parent_id": "null",
-    "members_count": "null"
+    "full_path": "user1"
   },
   {
     "id": 2,
@@ -40,7 +38,7 @@ Example response:
     "kind": "group",
     "full_path": "group1",
     "parent_id": "null",
-    "members_count": 2
+    "members_count_with_descendants": 2
 
   },
   {
@@ -49,11 +47,13 @@ Example response:
     "kind": "group",
     "full_path": "foo/bar",
     "parent_id": "9",
-    "members_count": 5
+    "members_count_with_descendants": 5
   }
 ]
 ```
 
+**Note**: `members_count_with_descendants` are presented only for group masters/owners.
+
 ## Search for namespace
 
 Get all namespaces that match a string in their name or path.
@@ -82,7 +82,7 @@ Example response:
     "kind": "group",
     "full_path": "twitter",
     "parent_id": "null",
-    "members_count": 2
+    "members_count_with_descendants": 2
   }
 ]
 ```