gitlab-org--gitlab-foss/doc/api/suggestions.md

45 lines
1.3 KiB
Markdown
Raw Normal View History

---
stage: Create
group: Source Code
info: "To determine the technical writer assigned to the Stage/Group associated with this page, see https://about.gitlab.com/handbook/engineering/ux/technical-writing/#assignments"
type: reference, api
---
# Suggest Changes API **(FREE)**
2018-12-18 03:59:50 -05:00
This page describes the API for [suggesting changes](../user/project/merge_requests/reviews/suggestions.md).
2018-12-18 03:59:50 -05:00
Every API call to suggestions must be authenticated.
## Applying suggestions
Applies a suggested patch in a merge request. Users must have
at least the Developer role to perform such action.
2018-12-18 03:59:50 -05:00
```plaintext
2018-12-18 03:59:50 -05:00
PUT /suggestions/:id/apply
```
| Attribute | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `id` | integer/string | yes | The ID of a suggestion |
| `commit_message` | string | no | A custom commit message to use instead of the default generated message or the project's default message |
2018-12-18 03:59:50 -05:00
```shell
curl --request PUT --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/suggestions/5/apply"
2018-12-18 03:59:50 -05:00
```
Example response:
```json
{
"id": 36,
"from_line": 10,
"to_line": 10,
"appliable": false,
"applied": true,
"from_content": " \"--talk-name=org.freedesktop.\",\n",
"to_content": " \"--talk-name=org.free.\",\n \"--talk-name=org.desktop.\",\n"
}
```