summaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
authorNejc Habjan <nejc.habjan@siemens.com>2022-11-10 12:39:37 +0100
committerJohn Villalovos <john@sodarock.com>2022-11-10 07:23:53 -0800
commit9bd433a3eb508b53fbca59f3f445da193522646a (patch)
tree921d1c8390daed4d0af130fd120c7c14878f1ac1 /docs
parentd0a034878fabfd8409134aa8b7ffeeb40219683c (diff)
downloadgitlab-9bd433a3eb508b53fbca59f3f445da193522646a.tar.gz
docs(groups): describe GitLab.com group creation limitation
Diffstat (limited to 'docs')
-rw-r--r--docs/gl_objects/groups.rst6
1 files changed, 6 insertions, 0 deletions
diff --git a/docs/gl_objects/groups.rst b/docs/gl_objects/groups.rst
index b467836..4a01253 100644
--- 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})