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

python-gitlab · Nov 10, 2022 · 9bd433a · 9bd433a
1 parent d0a0348
commit 9bd433a
Showing 1 changed file with 6 additions and 0 deletions.
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})