debian-mirror-gitlab/doc/api/merge_requests.md

897 lines
25 KiB
Markdown
Raw Normal View History

2014-09-02 18:07:02 +05:30
# Merge requests
## List merge requests
2016-04-02 18:10:28 +05:30
Get all merge requests for this project.
2015-11-26 14:37:03 +05:30
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.
2014-09-02 18:07:02 +05:30
```
GET /projects/:id/merge_requests
GET /projects/:id/merge_requests?state=opened
GET /projects/:id/merge_requests?state=all
2015-09-11 14:41:01 +05:30
GET /projects/:id/merge_requests?iid=42
2014-09-02 18:07:02 +05:30
```
Parameters:
- `id` (required) - The ID of a project
2015-09-11 14:41:01 +05:30
- `iid` (optional) - Return the request having the given `iid`
2014-09-02 18:07:02 +05:30
- `state` (optional) - Return `all` requests or just those that are `merged`, `opened` or `closed`
2015-04-26 12:48:37 +05:30
- `order_by` (optional) - Return requests ordered by `created_at` or `updated_at` fields. Default is `created_at`
- `sort` (optional) - Return requests sorted in `asc` or `desc` order. Default is `desc`
2014-09-02 18:07:02 +05:30
```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@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"
},
2016-08-24 12:49:21 +05:30
"source_project_id": 2,
"target_project_id": 3,
2016-04-02 18:10:28 +05:30
"labels": [ ],
2016-08-24 12:49:21 +05:30
"description": "fixed login page css paddings",
2016-04-02 18:10:28 +05:30
"work_in_progress": false,
"milestone": {
"id": 5,
"iid": 1,
"project_id": 3,
"title": "v2.0",
"description": "Assumenda aut placeat expedita exercitationem labore sunt enim earum.",
"state": "closed",
"created_at": "2015-02-02T19:49:26.013Z",
"updated_at": "2015-02-02T19:49:26.013Z",
"due_date": null
},
"merge_when_build_succeeds": true,
2016-06-02 11:05:42 +05:30
"merge_status": "can_be_merged",
"subscribed" : false,
2016-08-24 12:49:21 +05:30
"user_notes_count": 1,
"should_remove_source_branch": true,
"force_remove_source_branch": false
2014-09-02 18:07:02 +05:30
}
]
```
## Get single MR
Shows information about a single merge request.
2014-09-02 18:07:02 +05:30
```
2016-04-02 18:10:28 +05:30
GET /projects/:id/merge_requests/:merge_request_id
2014-09-02 18:07:02 +05:30
```
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@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"
},
2016-08-24 12:49:21 +05:30
"source_project_id": 2,
"target_project_id": 3,
2016-04-02 18:10:28 +05:30
"labels": [ ],
2016-08-24 12:49:21 +05:30
"description": "fixed login page css paddings",
2016-04-02 18:10:28 +05:30
"work_in_progress": false,
"milestone": {
"id": 5,
"iid": 1,
"project_id": 3,
"title": "v2.0",
"description": "Assumenda aut placeat expedita exercitationem labore sunt enim earum.",
"state": "closed",
"created_at": "2015-02-02T19:49:26.013Z",
"updated_at": "2015-02-02T19:49:26.013Z",
"due_date": null
},
"merge_when_build_succeeds": true,
2016-06-02 11:05:42 +05:30
"merge_status": "can_be_merged",
"subscribed" : true,
2016-08-24 12:49:21 +05:30
"user_notes_count": 1,
"should_remove_source_branch": true,
"force_remove_source_branch": false
2014-09-02 18:07:02 +05:30
}
```
2015-12-23 02:04:40 +05:30
## Get single MR commits
Get a list of merge request commits.
```
2016-04-02 18:10:28 +05:30
GET /projects/:id/merge_requests/:merge_request_id/commits
2015-12-23 02:04:40 +05:30
```
Parameters:
- `id` (required) - The ID of a project
- `merge_request_id` (required) - The ID of MR
```json
[
{
"id": "ed899a2f4b50b4370feeea94676502b42383c746",
"short_id": "ed899a2f4b5",
"title": "Replace sanitize with escape once",
"author_name": "Dmitriy Zaporozhets",
"author_email": "dzaporozhets@sphereconsultinginc.com",
"created_at": "2012-09-20T11:50:22+03:00",
"message": "Replace sanitize with escape once"
},
{
"id": "6104942438c14ec7bd21c6cd5bd995272b3faff6",
"short_id": "6104942438c",
"title": "Sanitize for network graph",
"author_name": "randx",
"author_email": "dmitriy.zaporozhets@gmail.com",
"created_at": "2012-09-20T09:06:12+03:00",
"message": "Sanitize for network graph"
}
]
```
2015-04-26 12:48:37 +05:30
## Get single MR changes
2015-11-26 14:37:03 +05:30
Shows information about the merge request including its files and changes.
2015-04-26 12:48:37 +05:30
```
2016-04-02 18:10:28 +05:30
GET /projects/:id/merge_requests/:merge_request_id/changes
2015-04-26 12:48:37 +05:30
```
Parameters:
- `id` (required) - The ID of a project
- `merge_request_id` (required) - The ID of MR
```json
{
"id": 21,
"iid": 1,
"project_id": 4,
"title": "Blanditiis beatae suscipit hic assumenda et molestias nisi asperiores repellat et.",
"state": "reopened",
"created_at": "2015-02-02T19:49:39.159Z",
"updated_at": "2015-02-02T20:08:49.959Z",
"target_branch": "secret_token",
"source_branch": "version-1-9",
"upvotes": 0,
"downvotes": 0,
"author": {
"name": "Chad Hamill",
"username": "jarrett",
"id": 5,
"state": "active",
"avatar_url": "http://www.gravatar.com/avatar/b95567800f828948baf5f4160ebb2473?s=40&d=identicon"
},
"assignee": {
"name": "Administrator",
"username": "root",
"id": 1,
"state": "active",
"avatar_url": "http://www.gravatar.com/avatar/e64c7d89f26bd1972efa854d13d7dd61?s=40&d=identicon"
},
"source_project_id": 4,
"target_project_id": 4,
"labels": [ ],
2016-04-02 18:10:28 +05:30
"description": "Qui voluptatibus placeat ipsa alias quasi. Deleniti rem ut sint. Optio velit qui distinctio.",
"work_in_progress": false,
2015-04-26 12:48:37 +05:30
"milestone": {
"id": 5,
"iid": 1,
"project_id": 4,
"title": "v2.0",
"description": "Assumenda aut placeat expedita exercitationem labore sunt enim earum.",
"state": "closed",
"created_at": "2015-02-02T19:49:26.013Z",
"updated_at": "2015-02-02T19:49:26.013Z",
"due_date": null
},
2016-04-02 18:10:28 +05:30
"merge_when_build_succeeds": true,
"merge_status": "can_be_merged",
2016-06-02 11:05:42 +05:30
"subscribed" : true,
"user_notes_count": 1,
2016-08-24 12:49:21 +05:30
"should_remove_source_branch": true,
"force_remove_source_branch": false,
2015-12-23 02:04:40 +05:30
"changes": [
2015-04-26 12:48:37 +05:30
{
"old_path": "VERSION",
"new_path": "VERSION",
"a_mode": "100644",
"b_mode": "100644",
"diff": "--- a/VERSION\ +++ b/VERSION\ @@ -1 +1 @@\ -1.9.7\ +1.9.8",
"new_file": false,
"renamed_file": false,
"deleted_file": false
}
]
}
```
2014-09-02 18:07:02 +05:30
## Create MR
Creates a new merge request.
2014-09-02 18:07:02 +05:30
```
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
2015-04-26 12:48:37 +05:30
- `description` (optional) - Description of MR
2014-09-02 18:07:02 +05:30
- `target_project_id` (optional) - The target project (numeric id)
2015-10-24 18:46:33 +05:30
- `labels` (optional) - Labels for MR as a comma-separated list
2016-04-02 18:10:28 +05:30
- `milestone_id` (optional) - Milestone ID
2014-09-02 18:07:02 +05:30
```json
{
"id": 1,
2016-08-24 12:49:21 +05:30
"iid": 1,
2014-09-02 18:07:02 +05:30
"target_branch": "master",
"source_branch": "test1",
"project_id": 3,
"title": "test1",
"state": "opened",
"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"
},
2016-04-02 18:10:28 +05:30
"source_project_id": 4,
"target_project_id": 4,
"labels": [ ],
2016-08-24 12:49:21 +05:30
"description": "fixed login page css paddings",
2016-04-02 18:10:28 +05:30
"work_in_progress": false,
"milestone": {
"id": 5,
"iid": 1,
"project_id": 4,
"title": "v2.0",
"description": "Assumenda aut placeat expedita exercitationem labore sunt enim earum.",
"state": "closed",
"created_at": "2015-02-02T19:49:26.013Z",
"updated_at": "2015-02-02T19:49:26.013Z",
"due_date": null
},
"merge_when_build_succeeds": true,
2016-06-02 11:05:42 +05:30
"merge_status": "can_be_merged",
"subscribed" : true,
2016-08-24 12:49:21 +05:30
"user_notes_count": 0,
"should_remove_source_branch": true,
"force_remove_source_branch": false
2014-09-02 18:07:02 +05:30
}
```
If the operation is successful, 200 and the newly created merge request is returned.
If an error occurs, an error number and a message explaining the reason is returned.
## Update MR
Updates an existing merge request. You can change the target branch, title, or even close the MR.
2014-09-02 18:07:02 +05:30
```
2016-04-02 18:10:28 +05:30
PUT /projects/:id/merge_requests/:merge_request_id
2014-09-02 18:07:02 +05:30
```
Parameters:
- `id` (required) - The ID of a project
- `merge_request_id` (required) - ID of MR
- `target_branch` - The target branch
- `assignee_id` - Assignee user ID
- `title` - Title of MR
2015-04-26 12:48:37 +05:30
- `description` - Description of MR
2014-09-02 18:07:02 +05:30
- `state_event` - New state (close|reopen|merge)
2015-10-24 18:46:33 +05:30
- `labels` (optional) - Labels for MR as a comma-separated list
2016-04-02 18:10:28 +05:30
- `milestone_id` (optional) - Milestone ID
2014-09-02 18:07:02 +05:30
```json
{
"id": 1,
2016-08-24 12:49:21 +05:30
"iid": 1,
2014-09-02 18:07:02 +05:30
"target_branch": "master",
"project_id": 3,
"title": "test1",
"state": "opened",
"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"
2016-04-02 18:10:28 +05:30
},
"source_project_id": 4,
"target_project_id": 4,
"labels": [ ],
"description": "description1",
"work_in_progress": false,
"milestone": {
"id": 5,
"iid": 1,
"project_id": 4,
"title": "v2.0",
"description": "Assumenda aut placeat expedita exercitationem labore sunt enim earum.",
"state": "closed",
"created_at": "2015-02-02T19:49:26.013Z",
"updated_at": "2015-02-02T19:49:26.013Z",
"due_date": null
},
"merge_when_build_succeeds": true,
2016-06-02 11:05:42 +05:30
"merge_status": "can_be_merged",
"subscribed" : true,
2016-08-24 12:49:21 +05:30
"user_notes_count": 1,
"should_remove_source_branch": true,
"force_remove_source_branch": false
2014-09-02 18:07:02 +05:30
}
```
If the operation is successful, 200 and the updated merge request is returned.
If an error occurs, an error number and a message explaining the reason is returned.
2016-06-02 11:05:42 +05:30
## Delete a merge request
Only for admins and project owners. Soft deletes the merge request in question.
If the operation is successful, a status code `200` is returned. In case you cannot
destroy this merge request, or it is not present, code `404` is given.
```
DELETE /projects/:id/merge_requests/:merge_request_id
```
| Attribute | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `id` | integer | yes | The ID of a project |
| `merge_request_id` | integer | yes | The ID of a project's merge request |
```bash
2016-09-13 17:45:13 +05:30
curl --request DELETE --header "PRIVATE-TOKEN: 9koXpg98eAheJpvBs5tK" https://gitlab.example.com/api/v3/projects/4/merge_request/85
2016-06-02 11:05:42 +05:30
```
2014-09-02 18:07:02 +05:30
## Accept MR
Merge changes submitted with MR using this API.
2014-09-02 18:07:02 +05:30
If the merge succeeds you'll get a `200 OK`.
2014-09-02 18:07:02 +05:30
If it has some conflicts and can not be merged - you'll get a 405 and the error message 'Branch cannot be merged'
2014-09-02 18:07:02 +05:30
If merge request is already merged or closed - you'll get a 406 and the error message 'Method Not Allowed'
If the `sha` parameter is passed and does not match the HEAD of the source - you'll get a 409 and the error message 'SHA does not match HEAD of source branch'
2014-09-02 18:07:02 +05:30
If you don't have permissions to accept this merge request - you'll get a 401
```
2016-04-02 18:10:28 +05:30
PUT /projects/:id/merge_requests/:merge_request_id/merge
2014-09-02 18:07:02 +05:30
```
Parameters:
2015-12-23 02:04:40 +05:30
- `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
2016-08-24 12:49:21 +05:30
- `merge_when_build_succeeds` (optional) - if `true` the MR is merged when the build succeeds
- `sha` (optional) - if present, then this SHA must match the HEAD of the source branch, otherwise the merge will fail
2015-12-23 02:04:40 +05:30
```json
{
"id": 1,
2016-08-24 12:49:21 +05:30
"iid": 1,
2015-12-23 02:04:40 +05:30
"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"
2016-04-02 18:10:28 +05:30
},
"source_project_id": 4,
"target_project_id": 4,
"labels": [ ],
2016-08-24 12:49:21 +05:30
"description": "fixed login page css paddings",
2016-04-02 18:10:28 +05:30
"work_in_progress": false,
"milestone": {
"id": 5,
"iid": 1,
"project_id": 4,
"title": "v2.0",
"description": "Assumenda aut placeat expedita exercitationem labore sunt enim earum.",
"state": "closed",
"created_at": "2015-02-02T19:49:26.013Z",
"updated_at": "2015-02-02T19:49:26.013Z",
"due_date": null
},
"merge_when_build_succeeds": true,
2016-06-02 11:05:42 +05:30
"merge_status": "can_be_merged",
"subscribed" : true,
2016-08-24 12:49:21 +05:30
"user_notes_count": 1,
"should_remove_source_branch": true,
"force_remove_source_branch": false
2015-12-23 02:04:40 +05:30
}
```
## 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.
```
2016-04-02 18:10:28 +05:30
PUT /projects/:id/merge_requests/:merge_request_id/cancel_merge_when_build_succeeds
2015-12-23 02:04:40 +05:30
```
Parameters:
- `id` (required) - The ID of a project
- `merge_request_id` (required) - ID of MR
2014-09-02 18:07:02 +05:30
```json
{
"id": 1,
2016-08-24 12:49:21 +05:30
"iid": 1,
2014-09-02 18:07:02 +05:30
"target_branch": "master",
"source_branch": "test1",
"project_id": 3,
"title": "test1",
2016-04-02 18:10:28 +05:30
"state": "opened",
2014-09-02 18:07:02 +05:30
"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"
2016-04-02 18:10:28 +05:30
},
"source_project_id": 4,
"target_project_id": 4,
"labels": [ ],
2016-08-24 12:49:21 +05:30
"description": "fixed login page css paddings",
2016-04-02 18:10:28 +05:30
"work_in_progress": false,
"milestone": {
"id": 5,
"iid": 1,
"project_id": 4,
"title": "v2.0",
"description": "Assumenda aut placeat expedita exercitationem labore sunt enim earum.",
"state": "closed",
"created_at": "2015-02-02T19:49:26.013Z",
"updated_at": "2015-02-02T19:49:26.013Z",
"due_date": null
},
"merge_when_build_succeeds": true,
2016-06-02 11:05:42 +05:30
"merge_status": "can_be_merged",
"subscribed" : true,
2016-08-24 12:49:21 +05:30
"user_notes_count": 1,
"should_remove_source_branch": true,
"force_remove_source_branch": false
2014-09-02 18:07:02 +05:30
}
```
2016-06-02 11:05:42 +05:30
## Comments on merge requests
2014-09-02 18:07:02 +05:30
2016-04-02 18:10:28 +05:30
Comments are done via the [notes](notes.md) resource.
2014-09-02 18:07:02 +05:30
2016-04-02 18:10:28 +05:30
## List issues that will close on merge
2014-09-02 18:07:02 +05:30
2016-04-02 18:10:28 +05:30
Get all the issues that would be closed by merging the provided merge request.
2014-09-02 18:07:02 +05:30
2016-04-02 18:10:28 +05:30
```
GET /projects/:id/merge_requests/:merge_request_id/closes_issues
2014-09-02 18:07:02 +05:30
```
2016-04-02 18:10:28 +05:30
| Attribute | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `id` | integer | yes | The ID of a project |
| `merge_request_id` | integer | yes | The ID of the merge request |
2014-09-02 18:07:02 +05:30
2016-04-02 18:10:28 +05:30
```bash
2016-09-13 17:45:13 +05:30
curl --header "PRIVATE-TOKEN: 9koXpg98eAheJpvBs5tK" https://gitlab.example.com/api/v3/projects/76/merge_requests/1/closes_issues
2014-09-02 18:07:02 +05:30
```
Example response when the GitLab issue tracker is used:
2014-09-02 18:07:02 +05:30
```json
[
2016-04-02 18:10:28 +05:30
{
"state" : "opened",
"description" : "Ratione dolores corrupti mollitia soluta quia.",
"author" : {
"state" : "active",
"id" : 18,
"web_url" : "https://gitlab.example.com/u/eileen.lowe",
"name" : "Alexandra Bashirian",
"avatar_url" : null,
"username" : "eileen.lowe"
},
"milestone" : {
"project_id" : 1,
"description" : "Ducimus nam enim ex consequatur cumque ratione.",
"state" : "closed",
"due_date" : null,
"iid" : 2,
"created_at" : "2016-01-04T15:31:39.996Z",
"title" : "v4.0",
"id" : 17,
"updated_at" : "2016-01-04T15:31:39.996Z"
},
"project_id" : 1,
"assignee" : {
"state" : "active",
"id" : 1,
"name" : "Administrator",
"web_url" : "https://gitlab.example.com/u/root",
"avatar_url" : null,
"username" : "root"
},
"updated_at" : "2016-01-04T15:31:51.081Z",
"id" : 76,
"title" : "Consequatur vero maxime deserunt laboriosam est voluptas dolorem.",
"created_at" : "2016-01-04T15:31:51.081Z",
"iid" : 6,
2016-06-02 11:05:42 +05:30
"labels" : [],
"user_notes_count": 1
2016-04-02 18:10:28 +05:30
},
2014-09-02 18:07:02 +05:30
]
```
2016-06-02 11:05:42 +05:30
Example response when an external issue tracker (e.g. JIRA) is used:
```json
[
{
"id" : "PROJECT-123",
"title" : "Title of this issue"
}
]
```
2016-06-02 11:05:42 +05:30
## Subscribe to a merge request
Subscribes the authenticated user to a merge request to receive notification. If
the operation is successful, status code `201` together with the updated merge
request is returned. If the user is already subscribed to the merge request, the
status code `304` is returned. If the project or merge request is not found,
status code `404` is returned.
```
POST /projects/:id/merge_requests/:merge_request_id/subscription
```
| Attribute | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `id` | integer | yes | The ID of a project |
| `merge_request_id` | integer | yes | The ID of the merge request |
```bash
2016-09-13 17:45:13 +05:30
curl --request POST --header "PRIVATE-TOKEN: 9koXpg98eAheJpvBs5tK" https://gitlab.example.com/api/v3/projects/5/merge_requests/17/subscription
2016-06-02 11:05:42 +05:30
```
Example response:
```json
{
"id": 17,
"iid": 1,
"project_id": 5,
"title": "Et et sequi est impedit nulla ut rem et voluptatem.",
"description": "Consequatur velit eos rerum optio autem. Quia id officia quaerat dolorum optio. Illo laudantium aut ipsum dolorem.",
"state": "opened",
"created_at": "2016-04-05T21:42:23.233Z",
"updated_at": "2016-04-05T22:11:52.900Z",
"target_branch": "ui-dev-kit",
"source_branch": "version-1-9",
"upvotes": 0,
"downvotes": 0,
"author": {
"name": "Eileen Skiles",
"username": "leila",
"id": 19,
"state": "active",
"avatar_url": "http://www.gravatar.com/avatar/39ce4a2822cc896933ffbd68c1470e55?s=80&d=identicon",
"web_url": "https://gitlab.example.com/u/leila"
},
"assignee": {
"name": "Celine Wehner",
"username": "carli",
"id": 16,
"state": "active",
"avatar_url": "http://www.gravatar.com/avatar/f4cd5605b769dd2ce405a27c6e6f2684?s=80&d=identicon",
"web_url": "https://gitlab.example.com/u/carli"
},
"source_project_id": 5,
"target_project_id": 5,
"labels": [],
"work_in_progress": false,
"milestone": {
"id": 7,
"iid": 1,
"project_id": 5,
"title": "v2.0",
"description": "Corrupti eveniet et velit occaecati dolorem est rerum aut.",
"state": "closed",
"created_at": "2016-04-05T21:41:40.905Z",
"updated_at": "2016-04-05T21:41:40.905Z",
"due_date": null
},
"merge_when_build_succeeds": false,
"merge_status": "cannot_be_merged",
"subscribed": true
}
```
## Unsubscribe from a merge request
Unsubscribes the authenticated user from a merge request to not receive
notifications from that merge request. If the operation is successful, status
code `200` together with the updated merge request is returned. If the user is
not subscribed to the merge request, the status code `304` is returned. If the
project or merge request is not found, status code `404` is returned.
```
DELETE /projects/:id/merge_requests/:merge_request_id/subscription
```
| Attribute | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `id` | integer | yes | The ID of a project |
| `merge_request_id` | integer | yes | The ID of the merge request |
```bash
2016-09-13 17:45:13 +05:30
curl --request DELETE --header "PRIVATE-TOKEN: 9koXpg98eAheJpvBs5tK" https://gitlab.example.com/api/v3/projects/5/merge_requests/17/subscription
2016-06-02 11:05:42 +05:30
```
Example response:
```json
{
"id": 17,
"iid": 1,
"project_id": 5,
"title": "Et et sequi est impedit nulla ut rem et voluptatem.",
"description": "Consequatur velit eos rerum optio autem. Quia id officia quaerat dolorum optio. Illo laudantium aut ipsum dolorem.",
"state": "opened",
"created_at": "2016-04-05T21:42:23.233Z",
"updated_at": "2016-04-05T22:11:52.900Z",
"target_branch": "ui-dev-kit",
"source_branch": "version-1-9",
"upvotes": 0,
"downvotes": 0,
"author": {
"name": "Eileen Skiles",
"username": "leila",
"id": 19,
"state": "active",
"avatar_url": "http://www.gravatar.com/avatar/39ce4a2822cc896933ffbd68c1470e55?s=80&d=identicon",
"web_url": "https://gitlab.example.com/u/leila"
},
"assignee": {
"name": "Celine Wehner",
"username": "carli",
"id": 16,
"state": "active",
"avatar_url": "http://www.gravatar.com/avatar/f4cd5605b769dd2ce405a27c6e6f2684?s=80&d=identicon",
"web_url": "https://gitlab.example.com/u/carli"
},
"source_project_id": 5,
"target_project_id": 5,
"labels": [],
"work_in_progress": false,
"milestone": {
"id": 7,
"iid": 1,
"project_id": 5,
"title": "v2.0",
"description": "Corrupti eveniet et velit occaecati dolorem est rerum aut.",
"state": "closed",
"created_at": "2016-04-05T21:41:40.905Z",
"updated_at": "2016-04-05T21:41:40.905Z",
"due_date": null
},
"merge_when_build_succeeds": false,
"merge_status": "cannot_be_merged",
"subscribed": false
}
```
2016-08-24 12:49:21 +05:30
## Create a todo
Manually creates a todo for the current user on a merge request. If the
request is successful, status code `200` together with the created todo is
returned. If there already exists a todo for the user on that merge request,
status code `304` is returned.
```
POST /projects/:id/merge_requests/:merge_request_id/todo
```
| Attribute | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `id` | integer | yes | The ID of a project |
| `merge_request_id` | integer | yes | The ID of the merge request |
```bash
2016-09-13 17:45:13 +05:30
curl --request POST --header "PRIVATE-TOKEN: 9koXpg98eAheJpvBs5tK" https://gitlab.example.com/api/v3/projects/5/merge_requests/27/todo
2016-08-24 12:49:21 +05:30
```
Example response:
```json
{
"id": 113,
"project": {
"id": 3,
"name": "Gitlab Ci",
"name_with_namespace": "Gitlab Org / Gitlab Ci",
"path": "gitlab-ci",
"path_with_namespace": "gitlab-org/gitlab-ci"
},
"author": {
"name": "Administrator",
"username": "root",
"id": 1,
"state": "active",
"avatar_url": "http://www.gravatar.com/avatar/e64c7d89f26bd1972efa854d13d7dd61?s=80&d=identicon",
"web_url": "https://gitlab.example.com/u/root"
},
"action_name": "marked",
"target_type": "MergeRequest",
"target": {
"id": 27,
"iid": 7,
"project_id": 3,
"title": "Et voluptas laudantium minus nihil recusandae ut accusamus earum aut non.",
"description": "Veniam sunt nihil modi earum cumque illum delectus. Nihil ad quis distinctio quia. Autem eligendi at quibusdam repellendus.",
"state": "opened",
"created_at": "2016-06-17T07:48:04.330Z",
"updated_at": "2016-07-01T11:14:15.537Z",
"target_branch": "allow_regex_for_project_skip_ref",
"source_branch": "backup",
"upvotes": 0,
"downvotes": 0,
"author": {
"name": "Jarret O'Keefe",
"username": "francisca",
"id": 14,
"state": "active",
"avatar_url": "http://www.gravatar.com/avatar/a7fa515d53450023c83d62986d0658a8?s=80&d=identicon",
"web_url": "https://gitlab.example.com/u/francisca"
},
"assignee": {
"name": "Dr. Gabrielle Strosin",
"username": "barrett.krajcik",
"id": 4,
"state": "active",
"avatar_url": "http://www.gravatar.com/avatar/733005fcd7e6df12d2d8580171ccb966?s=80&d=identicon",
"web_url": "https://gitlab.example.com/u/barrett.krajcik"
},
"source_project_id": 3,
"target_project_id": 3,
"labels": [],
"work_in_progress": false,
"milestone": {
"id": 27,
"iid": 2,
"project_id": 3,
"title": "v1.0",
"description": "Quis ea accusantium animi hic fuga assumenda.",
"state": "active",
"created_at": "2016-06-17T07:47:33.840Z",
"updated_at": "2016-06-17T07:47:33.840Z",
"due_date": null
},
"merge_when_build_succeeds": false,
"merge_status": "unchecked",
"subscribed": true,
"user_notes_count": 7,
"should_remove_source_branch": true,
"force_remove_source_branch": false
},
"target_url": "https://gitlab.example.com/gitlab-org/gitlab-ci/merge_requests/7",
"body": "Et voluptas laudantium minus nihil recusandae ut accusamus earum aut non.",
"state": "pending",
"created_at": "2016-07-01T11:14:15.530Z"
}
```