Visual Review discussions API (deprecated)
DETAILS: Tier: Premium, Ultimate Offering: GitLab.com, Self-managed, GitLab Dedicated
WARNING: This feature was deprecated in GitLab 15.8 and is planned for removal in 17.0. This change is a breaking change.
Visual Review discussions are notes on merge requests sent as feedback from Visual Reviews.
Create new merge request thread
Creates a new thread to a single project merge request. This is similar to creating a note but other comments (replies) can be added to it later.
POST /projects/:id/merge_requests/:merge_request_iid/visual_review_discussionsParameters:
| Attribute | Type | Required | Description |
|---|---|---|---|
id |
integer/string | Yes | The ID or URL-encoded path of the project |
merge_request_iid |
integer | Yes | The IID of a merge request |
body |
string | Yes | The content of the thread |
position |
hash | No | Position when creating a diff note |
position[base_sha] |
string | Yes | Base commit SHA in the source branch |
position[start_sha] |
string | Yes | SHA referencing commit in target branch |
position[head_sha] |
string | Yes | SHA referencing HEAD of this merge request |
position[position_type] |
string | Yes | Type of the position reference. Either text or image. |
position[new_path] |
string | No | File path after change |
position[new_line] |
integer | No | Line number after change (Only stored for text diff notes) |
position[old_path] |
string | No | File path before change |
position[old_line] |
integer | No | Line number before change (Only stored for text diff notes) |
position[width] |
integer | No | Width of the image (Only stored for image diff notes) |
position[height] |
integer | No | Height of the image (Only stored for image diff notes) |
position[x] |
integer | No | X coordinate (Only stored for image diff notes) |
position[y] |
integer | No | Y coordinate (Only stored for image diff notes) |
curl --request POST --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/projects/5/merge_requests/11/visual_review_discussions?body=comment"