summaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
Diffstat (limited to 'docs')
-rw-r--r--docs/gl_objects/mr_approvals.rst30
1 files changed, 30 insertions, 0 deletions
diff --git a/docs/gl_objects/mr_approvals.rst b/docs/gl_objects/mr_approvals.rst
new file mode 100644
index 0000000..69d44a5
--- /dev/null
+++ b/docs/gl_objects/mr_approvals.rst
@@ -0,0 +1,30 @@
+##############################################
+Project-level merge request approvals settings
+##############################################
+
+References
+----------
+
+* v4 API:
+
+ + :class:`gitlab.v4.objects.ProjectApproval`
+ + :class:`gitlab.v4.objects.ProjectApprovalManager`
+ + :attr:`gitlab.v4.objects.Project.approvals`
+
+* GitLab API: https://docs.gitlab.com/ee/api/merge_request_approvals.html#project-level-mr-approvals
+
+Examples
+--------
+
+Get project-level MR approvals settings::
+
+ mras = project.approvals.get()
+
+Change project-level MR approvals settings::
+
+ mras.approvals_before_merge = 2
+ mras.save()
+
+Change project-level MR allowed approvers::
+
+ project.approvals.set_approvers(approver_ids = [105], approver_group_ids=[653, 654])