diff options
author | GitLab Bot <gitlab-bot@gitlab.com> | 2021-03-06 06:09:06 +0300 |
---|---|---|
committer | GitLab Bot <gitlab-bot@gitlab.com> | 2021-03-06 06:09:06 +0300 |
commit | 3d788391624d5def7d5d2e65705c3c852c6bc557 (patch) | |
tree | 5d390f7ebd05e8c13bb1d612e14a5ba67826d537 /doc/api/discussions.md | |
parent | 0313282761321e443e6342af3e897dd240d4141c (diff) |
Add latest changes from gitlab-org/gitlab@master
Diffstat (limited to 'doc/api/discussions.md')
-rw-r--r-- | doc/api/discussions.md | 21 |
1 files changed, 14 insertions, 7 deletions
diff --git a/doc/api/discussions.md b/doc/api/discussions.md index d88d4780e65..8b72f916759 100644 --- a/doc/api/discussions.md +++ b/doc/api/discussions.md @@ -839,7 +839,7 @@ a note but other comments (replies) can be added to it later. POST /projects/:id/merge_requests/:merge_request_iid/discussions ``` -Parameters: +Parameters for all comments: | Attribute | Type | Required | Description | | ---------------------------------------- | -------------- | -------- | ----------- | @@ -858,21 +858,28 @@ Parameters: | `position[old_path]` | string | no | File path before change | | `position[old_line]` | integer | no | Line number before change (for 'text' diff notes) | | `position[line_range]` | hash | no | Line range for a multi-line diff note | -| `position[line_range][start]` | hash | no | Multiline note starting line | -| `position[line_range][start][line_code]` | string | yes | Line code for the start line | -| `position[line_range][start][type]` | string | yes | Line type for the start line | -| `position[line_range][end]` | hash | no | Multiline note ending line | -| `position[line_range][end][line_code]` | string | yes | Line code for the end line | -| `position[line_range][end][type]` | string | yes | Line type for the end line | | `position[width]` | integer | no | Width of the image (for 'image' diff notes) | | `position[height]` | integer | no | Height of the image (for 'image' diff notes) | | `position[x]` | integer | no | X coordinate (for 'image' diff notes) | | `position[y]` | integer | no | Y coordinate (for 'image' diff notes) | +Parameters for multiline comments only: + +| Attribute | Type | Required | Description | +| ---------------------------------------- | -------------- | -------- | ----------- | +| `position[line_range][start]` | hash | no | Multiline note starting line | +| `position[line_range][start][line_code]` | string | no | Line code for the start line | +| `position[line_range][start][type]` | string | no | Line type for the start line | +| `position[line_range][end]` | hash | no | Multiline note ending line | +| `position[line_range][end][line_code]` | string | no | Line code for the end line | +| `position[line_range][end][type]` | string | no | Line type for the end line | + ```shell curl --request POST --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/projects/5/merge_requests/11/discussions?body=comment" ``` +There is currently no functional documented method of starting merge request discussions. Read [this issue](https://gitlab.com/gitlab-org/gitlab/-/issues/228807) for reflections. + ### Resolve a merge request thread Resolve/unresolve whole thread of a merge request. |