API: project events

1 files changed, 69 insertions, 0 deletions

diff --git a/doc/api/projects.md b/doc/api/projects.md
index f5f0afb2bc0..323c0be63a4 100644
--- a/doc/api/projects.md
+++ b/doc/api/projects.md
@@ -77,6 +77,7 @@ Parameters:
 {
   "id": 5,
   "name": "gitlab",
+  "name_with_namespace": "GitLab / gitlabhq",
   "description": null,
   "default_branch": "api",
   "owner": {
@@ -99,6 +100,74 @@ Parameters:
 }
 ```
 
+### Get project events
+
+Get a project events for specific project.
+Sorted from newest to latest
+
+```
+GET /projects/:id/events
+```
+
+Parameters:
+
++ `id` (required) - The ID or NAME of a project
+
+```json
+
+[{
+  "title": null,
+  "project_id": 15,
+  "action_name": "closed",
+  "target_id": 830,
+  "target_type": "Issue",
+  "author_id": 1,
+  "data": null,
+  "target_title": "Public project search field"
+}, {
+  "title": null,
+  "project_id": 15,
+  "action_name": "opened",
+  "target_id": null,
+  "target_type": null,
+  "author_id": 1,
+  "data": {
+    "before": "50d4420237a9de7be1304607147aec22e4a14af7",
+    "after": "c5feabde2d8cd023215af4d2ceeb7a64839fc428",
+    "ref": "refs/heads/master",
+    "user_id": 1,
+    "user_name": "Dmitriy Zaporozhets",
+    "repository": {
+      "name": "gitlabhq",
+      "url": "git@dev.gitlab.org:gitlab/gitlabhq.git",
+      "description": "GitLab: self hosted Git management software. \r\nDistributed under the MIT License.",
+      "homepage": "https://dev.gitlab.org/gitlab/gitlabhq"
+    },
+    "commits": [{
+      "id": "c5feabde2d8cd023215af4d2ceeb7a64839fc428",
+      "message": "Add simple search to projects in public area",
+      "timestamp": "2013-05-13T18:18:08+00:00",
+      "url": "https://dev.gitlab.org/gitlab/gitlabhq/commit/c5feabde2d8cd023215af4d2ceeb7a64839fc428",
+      "author": {
+        "name": "Dmitriy Zaporozhets",
+        "email": "dmitriy.zaporozhets@gmail.com"
+      }
+    }],
+    "total_commits_count": 1
+  },
+  "target_title": null
+}, {
+  "title": null,
+  "project_id": 15,
+  "action_name": "closed",
+  "target_id": 840,
+  "target_type": "Issue",
+  "author_id": 1,
+  "data": null,
+  "target_title": "Finish & merge Code search PR"
+}]
+```
+
 
 ### Create project