docs(groups): describe GitLab.com group creation limitation

nejch · JohnVillalovos · commit 9bd433a3eb50 · 2022-11-10T07:23:53.000-08:00
diff --git a/docs/gl_objects/groups.rst b/docs/gl_objects/groups.rst
@@ -60,6 +60,12 @@ Create a group::
 
     group = gl.groups.create({'name': 'group1', 'path': 'group1'})
 
+.. warning::
+
+   On GitLab.com, creating top-level groups is currently
+   `not permitted using the API <https://docs.gitlab.com/ee/api/groups.html#new-group>`_.
+   You can only use the API to create subgroups.
+
 Create a subgroup under an existing group::
 
     subgroup = gl.groups.create({'name': 'subgroup1', 'path': 'subgroup1', 'parent_id': parent_group_id})
