From 9bd433a3eb508b53fbca59f3f445da193522646a Mon Sep 17 00:00:00 2001
From: Nejc Habjan <nejc.habjan@siemens.com>
Date: Thu, 10 Nov 2022 12:39:37 +0100
Subject: docs(groups): describe GitLab.com group creation limitation

---
 docs/gl_objects/groups.rst | 6 ++++++
 1 file changed, 6 insertions(+)

(limited to 'docs')

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})
-- 
cgit v1.2.1