summaryrefslogtreecommitdiff
path: root/docs/gl_objects
diff options
context:
space:
mode:
authorMax Wittig <max.wittig@siemens.com>2018-11-28 18:02:58 +0100
committerGitHub <noreply@github.com>2018-11-28 18:02:58 +0100
commit20eb7d8900cdc24c3ea1e7ef2262dca9965a2884 (patch)
tree16d428a401f72018e4d9b2756e0ee3c8a5cc3778 /docs/gl_objects
parent22536f34d87e5df1a3400d3f474a988c93b9bfb1 (diff)
parent95d0d745d4bafe702c89c972f644b049d6c810ab (diff)
downloadgitlab-20eb7d8900cdc24c3ea1e7ef2262dca9965a2884.tar.gz
Merge pull request #625 from python-gitlab/fix/611/resource_label_event
Add support to resource label events
Diffstat (limited to 'docs/gl_objects')
-rw-r--r--docs/gl_objects/labels.rst39
-rw-r--r--docs/gl_objects/projects.rst2
2 files changed, 40 insertions, 1 deletions
diff --git a/docs/gl_objects/labels.rst b/docs/gl_objects/labels.rst
index 1c98971..a4667aa 100644
--- a/docs/gl_objects/labels.rst
+++ b/docs/gl_objects/labels.rst
@@ -2,6 +2,9 @@
Labels
######
+Project labels
+==============
+
Reference
---------
@@ -48,3 +51,39 @@ Manage labels in issues and merge requests::
'labels': ['foo']})
issue.labels.append('bar')
issue.save()
+
+Label events
+============
+
+Resource label events keep track about who, when, and which label was added or
+removed to an issuable.
+
+Group epic label events are only available in the EE edition.
+
+Reference
+---------
+
+* v4 API:
+
+ + :class:`gitlab.v4.objects.ProjectIssueResourceLabelEvent`
+ + :class:`gitlab.v4.objects.ProjectIssueResourceLabelEventManager`
+ + :attr:`gitlab.v4.objects.ProjectIssue.resourcelabelevents`
+ + :class:`gitlab.v4.objects.ProjectMergeRequestResourceLabelEvent`
+ + :class:`gitlab.v4.objects.ProjectMergeRequestResourceLabelEventManager`
+ + :attr:`gitlab.v4.objects.ProjectMergeRequest.resourcelabelevents`
+ + :class:`gitlab.v4.objects.GroupEpicResourceLabelEvent`
+ + :class:`gitlab.v4.objects.GroupEpicResourceLabelEventManager`
+ + :attr:`gitlab.v4.objects.GroupEpic.resourcelabelevents`
+
+* GitLab API: https://docs.gitlab.com/ee/api/resource_label_events.html
+
+Examples
+--------
+
+Get the events for a resource (issue, merge request or epic)::
+
+ events = resource.resourcelabelevents.list()
+
+Get a specific event for a resource::
+
+ event = resource.resourcelabelevents.get(event_id)
diff --git a/docs/gl_objects/projects.rst b/docs/gl_objects/projects.rst
index dd43294..a00aae0 100644
--- a/docs/gl_objects/projects.rst
+++ b/docs/gl_objects/projects.rst
@@ -664,7 +664,7 @@ Delete project push rules::
pr.delete()
Project protected tags
-==================
+======================
Reference
---------