# Merge requests ## List merge requests Get all merge requests for this project. The `state` parameter can be used to get only merge requests with a given state (`opened`, `closed`, or `merged`) or all of them (`all`). The pagination parameters `page` and `per_page` can be used to restrict the list of merge requests. ``` GET /projects/:id/merge_requests GET /projects/:id/merge_requests?state=opened GET /projects/:id/merge_requests?state=all ``` Parameters: - `id` (required) - The ID of a project - `state` (optional) - Return `all` requests or just those that are `merged`, `opened` or `closed` ```json [ { "id": 1, "iid": 1, "target_branch": "master", "source_branch": "test1", "project_id": 3, "title": "test1", "state": "opened", "upvotes": 0, "downvotes": 0, "author": { "id": 1, "username": "admin", "email": "admin@local.host", "name": "Administrator", "state": "active", "created_at": "2012-04-29T08:46:00Z" }, "assignee": { "id": 1, "username": "admin", "email": "admin@local.host", "name": "Administrator", "state": "active", "created_at": "2012-04-29T08:46:00Z" } } ] ``` ## Get single MR Shows information about a single merge request. ``` GET /projects/:id/merge_request/:merge_request_id ``` Parameters: - `id` (required) - The ID of a project - `merge_request_id` (required) - The ID of MR ```json { "id": 1, "iid": 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@local.host", "name": "Administrator", "state": "active", "created_at": "2012-04-29T08:46:00Z" }, "assignee": { "id": 1, "username": "admin", "email": "admin@local.host", "name": "Administrator", "state": "active", "created_at": "2012-04-29T08:46:00Z" } } ``` ## Create MR Creates a new merge request. ``` POST /projects/:id/merge_requests ``` Parameters: - `id` (required) - The ID of a project - `source_branch` (required) - The source branch - `target_branch` (required) - The target branch - `assignee_id` (optional) - Assignee user ID - `title` (required) - Title of MR - `target_project_id` (optional) - The target project (numeric id) ```json { "id": 1, "target_branch": "master", "source_branch": "test1", "project_id": 3, "title": "test1", "state": "opened", "upvotes": 0, "downvotes": 0, "author": { "id": 1, "username": "admin", "email": "admin@local.host", "name": "Administrator", "state": "active", "created_at": "2012-04-29T08:46:00Z" }, "assignee": { "id": 1, "username": "admin", "email": "admin@local.host", "name": "Administrator", "state": "active", "created_at": "2012-04-29T08:46:00Z" } } ``` ## Update MR Updates an existing merge request. You can change branches, title, or even close the MR. ``` PUT /projects/:id/merge_request/:merge_request_id ``` Parameters: - `id` (required) - The ID of a project - `merge_request_id` (required) - ID of MR - `source_branch` - The source branch - `target_branch` - The target branch - `assignee_id` - Assignee user ID - `title` - Title of MR - `state_event` - New state (close|reopen|merge) ```json { "id": 1, "target_branch": "master", "source_branch": "test1", "project_id": 3, "title": "test1", "state": "opened", "upvotes": 0, "downvotes": 0, "author": { "id": 1, "username": "admin", "email": "admin@local.host", "name": "Administrator", "state": "active", "created_at": "2012-04-29T08:46:00Z" }, "assignee": { "id": 1, "username": "admin", "email": "admin@local.host", "name": "Administrator", "state": "active", "created_at": "2012-04-29T08:46:00Z" } } ``` ## Accept MR Merge changes submitted with MR usign this API. If merge success you get 200 OK. If it has some conflicts and can not be merged - you get 405 and error message 'Branch cannot be merged' If merge request is already merged or closed - you get 405 and error message 'Method Not Allowed' If you dont have permissions to accept this merge request - you get 401 ``` 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 ```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@local.host", "name": "Administrator", "state": "active", "created_at": "2012-04-29T08:46:00Z" }, "assignee": { "id": 1, "username": "admin", "email": "admin@local.host", "name": "Administrator", "state": "active", "created_at": "2012-04-29T08:46:00Z" } } ``` ## Post comment to MR Adds a comment to a merge request. ``` POST /projects/:id/merge_request/:merge_request_id/comments ``` Parameters: - `id` (required) - The ID of a project - `merge_request_id` (required) - ID of merge request - `note` (required) - Text of comment ```json { "author": { "id": 1, "username": "admin", "email": "admin@local.host", "name": "Administrator", "blocked": false, "created_at": "2012-04-29T08:46:00Z" }, "note": "text1" } ``` ## Get the comments on a MR Gets all the comments associated with a merge request. ``` GET /projects/:id/merge_request/:merge_request_id/comments ``` Parameters: - `id` (required) - The ID of a project - `merge_request_id` (required) - ID of merge request ```json [ { "note": "this is the 1st comment on the 2merge merge request", "author": { "id": 11, "username": "admin", "email": "admin@local.host", "name": "Administrator", "state": "active", "created_at": "2014-03-06T08:17:35.000Z" } }, { "note": "_Status changed to closed_", "author": { "id": 11, "username": "admin", "email": "admin@local.host", "name": "Administrator", "state": "active", "created_at": "2014-03-06T08:17:35.000Z" } } ] ``` ## Comments on issues Comments are done via the notes resource.