Merge pull request #656 from esabouraud/feature-protectedbranchesoptions

Issue 653 Add access control options to protected branch creation

1 files changed, 9 insertions, 0 deletions

diff --git a/docs/gl_objects/protected_branches.rst b/docs/gl_objects/protected_branches.rst
index f0479e0..3498aa5 100644
--- a/docs/gl_objects/protected_branches.rst
+++ b/docs/gl_objects/protected_branches.rst
@@ -35,6 +35,15 @@ Create a protected branch::
         'push_access_level': gitlab.MAINTAINER_ACCESS
     })
 
+Create a protected branch with more granular access control::
+
+    p_branch = project.protectedbranches.create({
+        'name': '*-stable',
+        'allowed_to_push': [{"user_id": 99}, {"user_id": 98}],
+        'allowed_to_merge': [{"group_id": 653}],
+        'allowed_to_unprotect': [{"access_level": gitlab.MAINTAINER_ACCESS}]
+    })
+
 Delete a protected branch::
 
     project.protectedbranches.delete('*-stable')