Merge branch 'master' into default_clone_protocol_based_on_user_keys

2 files changed, 118 insertions, 6 deletions

diff --git a/doc/api/groups.md b/doc/api/groups.md
index 0b9f6406d8d..808675d8605 100644
--- a/doc/api/groups.md
+++ b/doc/api/groups.md
@@ -1,6 +1,6 @@
 # Groups

 

-## List project groups

+## List groups

 

 Get a list of groups. (As user: my groups, as admin: all groups)

 

@@ -21,6 +21,70 @@ GET /groups
 

 You can search for groups by name or path, see below.

 

+

+## List a group's projects

+

+Get a list of projects in this group.

+

+```

+GET /groups/:id/projects

+```

+

+Parameters:

+

+- `archived` (optional) - if passed, limit by archived status

+- `order_by` (optional) - Return requests ordered by `id`, `name`, `path`, `created_at`, `updated_at` or `last_activity_at` fields. Default is `created_at`

+- `sort` (optional) - Return requests sorted in `asc` or `desc` order. Default is `desc`

+- `search` (optional) - Return list of authorized projects according to a search criteria

+- `ci_enabled_first` - Return projects ordered by ci_enabled flag. Projects with enabled GitLab CI go first

+

+```json

+[

+  {

+    "id": 4,

+    "description": null,

+    "default_branch": "master",

+    "public": false,

+    "visibility_level": 0,

+    "ssh_url_to_repo": "git@example.com:diaspora/diaspora-client.git",

+    "http_url_to_repo": "http://example.com/diaspora/diaspora-client.git",

+    "web_url": "http://example.com/diaspora/diaspora-client",

+    "tag_list": [

+      "example",

+      "disapora client"

+    ],

+    "owner": {

+      "id": 3,

+      "name": "Diaspora",

+      "created_at": "2013-09-30T13: 46: 02Z"

+    },

+    "name": "Diaspora Client",

+    "name_with_namespace": "Diaspora / Diaspora Client",

+    "path": "diaspora-client",

+    "path_with_namespace": "diaspora/diaspora-client",

+    "issues_enabled": true,

+    "merge_requests_enabled": true,

+    "builds_enabled": true,

+    "wiki_enabled": true,

+    "snippets_enabled": false,

+    "created_at": "2013-09-30T13: 46: 02Z",

+    "last_activity_at": "2013-09-30T13: 46: 02Z",

+    "creator_id": 3,

+    "namespace": {

+      "created_at": "2013-09-30T13: 46: 02Z",

+      "description": "",

+      "id": 3,

+      "name": "Diaspora",

+      "owner_id": 1,

+      "path": "diaspora",

+      "updated_at": "2013-09-30T13: 46: 02Z"

+    },

+    "archived": false,

+    "avatar_url": "http://example.com/uploads/project/avatar/4/uploads/avatar.png"

+  }

+]

+```

+

 ## Details of a group

 

 Get all details of a group.

@@ -186,7 +250,7 @@ To get more (up to 100), pass the following as an argument to the API call:
 /groups?per_page=100

 ```

 

-And to switch pages add: 

+And to switch pages add:

 ```

 /groups?per_page=100&page=2

-```
\ No newline at end of file
+```

diff --git a/doc/api/merge_requests.md b/doc/api/merge_requests.md
index 82f2cef969f..366a1f8abec 100644
--- a/doc/api/merge_requests.md
+++ b/doc/api/merge_requests.md
@@ -335,9 +335,57 @@ PUT /projects/:id/merge_request/:merge_request_id/merge
 
 Parameters:
 
-- `id` (required)                   - The ID of a project
-- `merge_request_id` (required)     - ID of MR
-- `merge_commit_message` (optional) - Custom merge commit message
+- `id` (required)                           - The ID of a project
+- `merge_request_id` (required)             - ID of MR
+- `merge_commit_message` (optional)         - Custom merge commit message
+- `should_remove_source_branch` (optional)  - if `true` removes the source branch
+- `merged_when_build_succeeds` (optional)    - if `true` the MR is merge when the build succeeds
+
+```json
+{
+  "id": 1,
+  "target_branch": "master",
+  "source_branch": "test1",
+  "project_id": 3,
+  "title": "test1",
+  "state": "merged",
+  "upvotes": 0,
+  "downvotes": 0,
+  "author": {
+    "id": 1,
+    "username": "admin",
+    "email": "admin@example.com",
+    "name": "Administrator",
+    "state": "active",
+    "created_at": "2012-04-29T08:46:00Z"
+  },
+  "assignee": {
+    "id": 1,
+    "username": "admin",
+    "email": "admin@example.com",
+    "name": "Administrator",
+    "state": "active",
+    "created_at": "2012-04-29T08:46:00Z"
+  }
+}
+```
+
+## Cancel Merge When Build Succeeds
+
+If successful you'll get `200 OK`.
+
+If you don't have permissions to accept this merge request - you'll get a 401
+
+If the merge request is already merged or closed - you get 405 and error message 'Method Not Allowed'
+
+In case the merge request is not set to be merged when the build succeeds, you'll also get a 406 error.
+```
+PUT /projects/:id/merge_request/:merge_request_id/cancel_merge_when_build_succeeds
+```
+Parameters:
+
+- `id` (required)                           - The ID of a project
+- `merge_request_id` (required)             - ID of MR
 
 ```json
 {