Discussions

Use this API to manage discussions. This includes comments, threads, and system notes about changes to an object (for example, when a milestone changes).

To manage label notes, use the resource label events API.

List all discussions for an issue

GET /api/v4/projects/{id}/issues/{noteable_id}/discussions

Lists all discussions for a specified issue.

Parameters

Name	Type	Description
`id` Path, required	String	ID or URL-encoded path of the project
`noteable_id` Path, required	Integer	ID of the issue
`page` Query	Integer	Page number of results to retrieve Default: `1` Example: `1`
`per_page` Query	Integer	Number of items to list per page Default: `20` Example: `20`

Responses

Code	Description	Schema
`200`	OK	APIEntitiesDiscussion
`400`	Bad Request	—
`404`	Not Found	—

Create an issue discussion

POST /api/v4/projects/{id}/issues/{noteable_id}/discussions

Creates a discussion for a specified issue. Replies can be added to it later.

Parameters

Name	Type	Description
`id` Path, required	String	ID or URL-encoded path of the project
`noteable_id` Path, required	Integer	ID of the issue

Request body (application/json)

Property	Type	Description
`body` Required	String	Content of the note or reply
`created_at`	String	Date and time the note was created, in ISO 8601 format such as `2016-03-11T03:45:40Z`. Requires administrator or project/group owner rights

Responses

Code	Description	Schema
`201`	Created	APIEntitiesDiscussion
`400`	Bad Request	—
`404`	Not Found	—

Retrieve a discussion for an issue

GET /api/v4/projects/{id}/issues/{noteable_id}/discussions/{discussion_id}

Retrieves a specified discussion for an issue.

Parameters

Name	Type	Description
`id` Path, required	String	ID or URL-encoded path of the project
`discussion_id` Path, required	String	ID of the discussion
`noteable_id` Path, required	Integer	ID of the issue

Responses

Code	Description	Schema
`200`	OK	APIEntitiesDiscussion
`400`	Bad Request	—
`404`	Not Found	—

Resolve or unresolve an issue discussion

PUT /api/v4/projects/{id}/issues/{noteable_id}/discussions/{discussion_id}

Resolves or unresolves a specified issue discussion.

Parameters

Name	Type	Description
`id` Path, required	String	ID or URL-encoded path of the project
`noteable_id` Path, required	Integer	ID of the issue
`discussion_id` Path, required	String	ID of the discussion

Request body (application/json)

Property	Type	Description
`resolved` Required	Boolean	If `true`, resolves the discussion. If `false`, reopens the discussion

Responses

Code	Description	Schema
`200`	OK	APIEntitiesDiscussion
`400`	Bad Request	—
`404`	Not Found	—

List comments in an issue discussion

GET /api/v4/projects/{id}/issues/{noteable_id}/discussions/{discussion_id}/notes

Lists the comments in a specified issue discussion.

Parameters

Name	Type	Description
`id` Path, required	String	ID or URL-encoded path of the project
`discussion_id` Path, required	String	ID of the discussion
`noteable_id` Path, required	Integer	ID of the issue

Responses

Code	Description	Schema
`200`	OK	APIEntitiesDiscussion
`400`	Bad Request	—
`404`	Not Found	—

Add a comment to an issue discussion

POST /api/v4/projects/{id}/issues/{noteable_id}/discussions/{discussion_id}/notes

Adds a comment to a specified issue discussion.

Parameters

Name	Type	Description
`id` Path, required	String	ID or URL-encoded path of the project
`noteable_id` Path, required	Integer	ID of the issue
`discussion_id` Path, required	String	ID of the discussion

Request body (application/json)

Property	Type	Description
`body` Required	String	Content of the note or reply
`created_at`	String	Date and time the note was created, in ISO 8601 format such as `2016-03-11T03:45:40Z`. Requires administrator or project/group owner rights

Responses

Code	Description	Schema
`201`	Created	APIEntitiesNote
`400`	Bad Request	—
`404`	Not Found	—

Retrieve a comment from an issue discussion

GET /api/v4/projects/{id}/issues/{noteable_id}/discussions/{discussion_id}/notes/{note_id}

Retrieves a specified comment from a issue discussion.

Parameters

Name	Type	Description
`id` Path, required	String	ID or URL-encoded path of the project
`noteable_id` Path, required	Integer	ID of the issue
`discussion_id` Path, required	String	ID of the discussion
`note_id` Path, required	Integer	ID of the discussion note

Responses

Code	Description	Schema
`200`	OK	APIEntitiesNote
`400`	Bad Request	—
`404`	Not Found	—

Update a comment in an issue discussion

PUT /api/v4/projects/{id}/issues/{noteable_id}/discussions/{discussion_id}/notes/{note_id}

Updates or changes the status of a specified comment in a issue discussion.

Parameters

Name	Type	Description
`id` Path, required	String	ID or URL-encoded path of the project
`noteable_id` Path, required	Integer	ID of the issue
`discussion_id` Path, required	String	ID of the discussion
`note_id` Path, required	Integer	ID of the discussion note

Request body (application/json)

Property	Type	Description
`body`	String	Content of the note or reply. Exactly one of `body`, `resolved` must be provided
`resolved`	Boolean	If `true`, resolves the note. If `false`, reopens the note. Exactly one of `body`, `resolved` must be provided

Responses

Code	Description	Schema
`200`	OK	APIEntitiesNote
`400`	Bad Request	—
`404`	Not Found	—

Delete a comment from an issue discussion

DELETE /api/v4/projects/{id}/issues/{noteable_id}/discussions/{discussion_id}/notes/{note_id}

Deletes a specified comment from a issue discussion.

Parameters

Name	Type	Description
`id` Path, required	String	ID or URL-encoded path of the project
`noteable_id` Path, required	Integer	ID of the issue
`discussion_id` Path, required	String	ID of the discussion
`note_id` Path, required	Integer	ID of the discussion note

Responses

Code	Description	Schema
`200`	OK	APIEntitiesNote
`400`	Bad Request	—
`404`	Not Found	—

List all discussions for a merge request

GET /api/v4/projects/{id}/merge_requests/{noteable_id}/discussions

Lists all discussions for a specified merge request.

Parameters

Name	Type	Description
`id` Path, required	String	ID or URL-encoded path of the project
`noteable_id` Path, required	Integer	ID of the merge request
`page` Query	Integer	Page number of results to retrieve Default: `1` Example: `1`
`per_page` Query	Integer	Number of items to list per page Default: `20` Example: `20`

Responses

Code	Description	Schema
`200`	OK	APIEntitiesDiscussion
`400`	Bad Request	—
`404`	Not Found	—

Create a merge request discussion

POST /api/v4/projects/{id}/merge_requests/{noteable_id}/discussions

Creates a discussion for a specified merge request. Replies can be added to it later.

Parameters

Name	Type	Description
`id` Path, required	String	ID or URL-encoded path of the project
`noteable_id` Path, required	Integer	ID of the merge request

Request body (application/json)

Property	Type	Description
`body` Required	String	Content of the note or reply
`created_at`	String	Date and time the note was created, in ISO 8601 format such as `2016-03-11T03:45:40Z`. Requires administrator or project/group owner rights
`position`	Object	Position when creating a note
`position.base_sha` Required	String	Base commit SHA in the source branch
`position.head_sha` Required	String	SHA referencing HEAD of this merge request
`position.height`	Integer	Height of the image
`position.line_range`	Object	Multi-line start and end
`position.line_range.end`	Object	End line for a multi-line note
`position.line_range.end.line_code`	String	End line code for multi-line note
`position.line_range.end.new_line`	Integer	End new_line line number
`position.line_range.end.old_line`	Integer	End old_line line number
`position.line_range.end.type`	String	End line type for multi-line note
`position.line_range.start`	Object	Start line for a multi-line note
`position.line_range.start.line_code`	String	Start line code for multi-line note
`position.line_range.start.new_line`	Integer	Start new_line line number
`position.line_range.start.old_line`	Integer	Start old_line line number
`position.line_range.start.type`	String	Start line type for multi-line note
`position.new_line`	Integer	Line number after change
`position.new_path`	String	File path after change
`position.old_line`	Integer	Line number before change
`position.old_path`	String	File path before change
`position.position_type` Required	String	Type of the position reference Allowed values: `text`, `image`, `file` Minimum length: `1`
`position.start_sha` Required	String	SHA referencing commit in target branch
`position.width`	Integer	Width of the image
`position.x`	Integer	X coordinate in the image
`position.y`	Integer	Y coordinate in the image

Responses

Code	Description	Schema
`201`	Created	APIEntitiesDiscussion
`400`	Bad Request	—
`404`	Not Found	—

Retrieve a discussion for a merge request

GET /api/v4/projects/{id}/merge_requests/{noteable_id}/discussions/{discussion_id}

Retrieves a specified discussion for a merge request.

Parameters

Name	Type	Description
`id` Path, required	String	ID or URL-encoded path of the project
`discussion_id` Path, required	String	ID of the discussion
`noteable_id` Path, required	Integer	ID of the merge request

Responses

Code	Description	Schema
`200`	OK	APIEntitiesDiscussion
`400`	Bad Request	—
`404`	Not Found	—

Resolve or unresolve a merge request discussion

PUT /api/v4/projects/{id}/merge_requests/{noteable_id}/discussions/{discussion_id}

Resolves or unresolves a specified merge request discussion.

Parameters

Name	Type	Description
`id` Path, required	String	ID or URL-encoded path of the project
`noteable_id` Path, required	Integer	ID of the merge request
`discussion_id` Path, required	String	ID of the discussion

Request body (application/json)

Property	Type	Description
`resolved` Required	Boolean	If `true`, resolves the discussion. If `false`, reopens the discussion

Responses

Code	Description	Schema
`200`	OK	APIEntitiesDiscussion
`400`	Bad Request	—
`404`	Not Found	—

List comments in a merge request discussion

GET /api/v4/projects/{id}/merge_requests/{noteable_id}/discussions/{discussion_id}/notes

Lists the comments in a specified merge request discussion.

Parameters

Name	Type	Description
`id` Path, required	String	ID or URL-encoded path of the project
`discussion_id` Path, required	String	ID of the discussion
`noteable_id` Path, required	Integer	ID of the merge request

Responses

Code	Description	Schema
`200`	OK	APIEntitiesDiscussion
`400`	Bad Request	—
`404`	Not Found	—

Add a comment to a merge request discussion

POST /api/v4/projects/{id}/merge_requests/{noteable_id}/discussions/{discussion_id}/notes

Adds a comment to a specified merge request discussion.

Parameters

Name	Type	Description
`id` Path, required	String	ID or URL-encoded path of the project
`noteable_id` Path, required	Integer	ID of the merge request
`discussion_id` Path, required	String	ID of the discussion

Request body (application/json)

Property	Type	Description
`body` Required	String	Content of the note or reply
`created_at`	String	Date and time the note was created, in ISO 8601 format such as `2016-03-11T03:45:40Z`. Requires administrator or project/group owner rights

Responses

Code	Description	Schema
`201`	Created	APIEntitiesNote
`400`	Bad Request	—
`404`	Not Found	—

Retrieve a comment from a merge request discussion

GET /api/v4/projects/{id}/merge_requests/{noteable_id}/discussions/{discussion_id}/notes/{note_id}

Retrieves a specified comment from a merge request discussion.

Parameters

Name	Type	Description
`id` Path, required	String	ID or URL-encoded path of the project
`noteable_id` Path, required	Integer	ID of the merge request
`discussion_id` Path, required	String	ID of the discussion
`note_id` Path, required	Integer	ID of the discussion note

Responses

Code	Description	Schema
`200`	OK	APIEntitiesNote
`400`	Bad Request	—
`404`	Not Found	—

Update a comment in a merge request discussion

PUT /api/v4/projects/{id}/merge_requests/{noteable_id}/discussions/{discussion_id}/notes/{note_id}

Updates or changes the status of a specified comment in a merge request discussion.

Parameters

Name	Type	Description
`id` Path, required	String	ID or URL-encoded path of the project
`noteable_id` Path, required	Integer	ID of the merge request
`discussion_id` Path, required	String	ID of the discussion
`note_id` Path, required	Integer	ID of the discussion note

Request body (application/json)

Property	Type	Description
`body`	String	Content of the note or reply. Exactly one of `body`, `resolved` must be provided
`resolved`	Boolean	If `true`, resolves the note. If `false`, reopens the note. Exactly one of `body`, `resolved` must be provided

Responses

Code	Description	Schema
`200`	OK	APIEntitiesNote
`400`	Bad Request	—
`404`	Not Found	—

Delete a comment from a merge request discussion

DELETE /api/v4/projects/{id}/merge_requests/{noteable_id}/discussions/{discussion_id}/notes/{note_id}

Deletes a specified comment from a merge request discussion.

Parameters

Name	Type	Description
`id` Path, required	String	ID or URL-encoded path of the project
`noteable_id` Path, required	Integer	ID of the merge request
`discussion_id` Path, required	String	ID of the discussion
`note_id` Path, required	Integer	ID of the discussion note

Responses

Code	Description	Schema
`200`	OK	APIEntitiesNote
`400`	Bad Request	—
`404`	Not Found	—

List all discussions for a commit

GET /api/v4/projects/{id}/repository/commits/{noteable_id}/discussions

Lists all discussions for a specified commit.

Parameters

Name	Type	Description
`id` Path, required	String	ID or URL-encoded path of the project
`noteable_id` Path, required	String	ID of the commit
`page` Query	Integer	Page number of results to retrieve Default: `1` Example: `1`
`per_page` Query	Integer	Number of items to list per page Default: `20` Example: `20`

Responses

Code	Description	Schema
`200`	OK	APIEntitiesDiscussion
`400`	Bad Request	—
`404`	Not Found	—

Create a commit discussion

POST /api/v4/projects/{id}/repository/commits/{noteable_id}/discussions

Creates a discussion for a specified commit. Replies can be added to it later.

Parameters

Name	Type	Description
`id` Path, required	String	ID or URL-encoded path of the project
`noteable_id` Path, required	String	ID of the commit

Request body (application/json)

Property	Type	Description
`body` Required	String	Content of the note or reply
`created_at`	String	Date and time the note was created, in ISO 8601 format such as `2016-03-11T03:45:40Z`. Requires administrator or project/group owner rights
`position`	Object	Position when creating a note
`position.base_sha` Required	String	Base commit SHA in the source branch
`position.head_sha` Required	String	SHA referencing HEAD of this merge request
`position.height`	Integer	Height of the image
`position.new_line`	Integer	Line number after change
`position.new_path`	String	File path after change
`position.old_line`	Integer	Line number before change
`position.old_path`	String	File path before change
`position.position_type` Required	String	Type of the position reference Allowed values: `text`, `image`, `file` Minimum length: `1`
`position.start_sha` Required	String	SHA referencing commit in target branch
`position.width`	Integer	Width of the image
`position.x`	Integer	X coordinate in the image
`position.y`	Integer	Y coordinate in the image

Responses

Code	Description	Schema
`201`	Created	APIEntitiesDiscussion
`400`	Bad Request	—
`404`	Not Found	—

Retrieve a discussion for a commit

GET /api/v4/projects/{id}/repository/commits/{noteable_id}/discussions/{discussion_id}

Retrieves a specified discussion for a commit.

Parameters

Name	Type	Description
`id` Path, required	String	ID or URL-encoded path of the project
`discussion_id` Path, required	String	ID of the discussion
`noteable_id` Path, required	String	ID of the commit

Responses

Code	Description	Schema
`200`	OK	APIEntitiesDiscussion
`400`	Bad Request	—
`404`	Not Found	—

List comments in a commit discussion

GET /api/v4/projects/{id}/repository/commits/{noteable_id}/discussions/{discussion_id}/notes

Lists the comments in a specified commit discussion.

Parameters

Name	Type	Description
`id` Path, required	String	ID or URL-encoded path of the project
`discussion_id` Path, required	String	ID of the discussion
`noteable_id` Path, required	String	ID of the commit

Responses

Code	Description	Schema
`200`	OK	APIEntitiesDiscussion
`400`	Bad Request	—
`404`	Not Found	—

Add a comment to a commit discussion

POST /api/v4/projects/{id}/repository/commits/{noteable_id}/discussions/{discussion_id}/notes

Adds a comment to a specified commit discussion.

Parameters

Name	Type	Description
`id` Path, required	String	ID or URL-encoded path of the project
`noteable_id` Path, required	String	ID of the commit
`discussion_id` Path, required	String	ID of the discussion

Request body (application/json)

Property	Type	Description
`body` Required	String	Content of the note or reply
`created_at`	String	Date and time the note was created, in ISO 8601 format such as `2016-03-11T03:45:40Z`. Requires administrator or project/group owner rights

Responses

Code	Description	Schema
`201`	Created	APIEntitiesNote
`400`	Bad Request	—
`404`	Not Found	—

Retrieve a comment from a commit discussion

GET /api/v4/projects/{id}/repository/commits/{noteable_id}/discussions/{discussion_id}/notes/{note_id}

Retrieves a specified comment from a commit discussion.

Parameters

Name	Type	Description
`id` Path, required	String	ID or URL-encoded path of the project
`noteable_id` Path, required	String	ID of the commit
`discussion_id` Path, required	String	ID of the discussion
`note_id` Path, required	Integer	ID of the discussion note

Responses

Code	Description	Schema
`200`	OK	APIEntitiesNote
`400`	Bad Request	—
`404`	Not Found	—

Update a comment in a commit discussion

PUT /api/v4/projects/{id}/repository/commits/{noteable_id}/discussions/{discussion_id}/notes/{note_id}

Updates or changes the status of a specified comment in a commit discussion.

Parameters

Name	Type	Description
`id` Path, required	String	ID or URL-encoded path of the project
`noteable_id` Path, required	String	ID of the commit
`discussion_id` Path, required	String	ID of the discussion
`note_id` Path, required	Integer	ID of the discussion note

Request body (application/json)

Property	Type	Description
`body`	String	Content of the note or reply. Exactly one of `body`, `resolved` must be provided
`resolved`	Boolean	If `true`, resolves the note. If `false`, reopens the note. Exactly one of `body`, `resolved` must be provided

Responses

Code	Description	Schema
`200`	OK	APIEntitiesNote
`400`	Bad Request	—
`404`	Not Found	—

Delete a comment from a commit discussion

DELETE /api/v4/projects/{id}/repository/commits/{noteable_id}/discussions/{discussion_id}/notes/{note_id}

Deletes a specified comment from a commit discussion.

Parameters

Name	Type	Description
`id` Path, required	String	ID or URL-encoded path of the project
`noteable_id` Path, required	String	ID of the commit
`discussion_id` Path, required	String	ID of the discussion
`note_id` Path, required	Integer	ID of the discussion note

Responses

Code	Description	Schema
`200`	OK	APIEntitiesNote
`400`	Bad Request	—
`404`	Not Found	—

List all discussions for a snippet

GET /api/v4/projects/{id}/snippets/{noteable_id}/discussions

Lists all discussions for a specified snippet.

Parameters

Name	Type	Description
`id` Path, required	String	ID or URL-encoded path of the project
`noteable_id` Path, required	Integer	ID of the snippet
`page` Query	Integer	Page number of results to retrieve Default: `1` Example: `1`
`per_page` Query	Integer	Number of items to list per page Default: `20` Example: `20`

Responses

Code	Description	Schema
`200`	OK	APIEntitiesDiscussion
`400`	Bad Request	—
`404`	Not Found	—

Create a snippet discussion

POST /api/v4/projects/{id}/snippets/{noteable_id}/discussions

Creates a discussion for a specified snippet. Replies can be added to it later.

Parameters

Name	Type	Description
`id` Path, required	String	ID or URL-encoded path of the project
`noteable_id` Path, required	Integer	ID of the snippet

Request body (application/json)

Property	Type	Description
`body` Required	String	Content of the note or reply
`created_at`	String	Date and time the note was created, in ISO 8601 format such as `2016-03-11T03:45:40Z`. Requires administrator or project/group owner rights

Responses

Code	Description	Schema
`201`	Created	APIEntitiesDiscussion
`400`	Bad Request	—
`404`	Not Found	—

Retrieve a discussion for a snippet

GET /api/v4/projects/{id}/snippets/{noteable_id}/discussions/{discussion_id}

Retrieves a specified discussion for a snippet.

Parameters

Name	Type	Description
`id` Path, required	String	ID or URL-encoded path of the project
`discussion_id` Path, required	String	ID of the discussion
`noteable_id` Path, required	Integer	ID of the snippet

Responses

Code	Description	Schema
`200`	OK	APIEntitiesDiscussion
`400`	Bad Request	—
`404`	Not Found	—

List comments in a snippet discussion

GET /api/v4/projects/{id}/snippets/{noteable_id}/discussions/{discussion_id}/notes

Lists the comments in a specified snippet discussion.

Parameters

Name	Type	Description
`id` Path, required	String	ID or URL-encoded path of the project
`discussion_id` Path, required	String	ID of the discussion
`noteable_id` Path, required	Integer	ID of the snippet

Responses

Code	Description	Schema
`200`	OK	APIEntitiesDiscussion
`400`	Bad Request	—
`404`	Not Found	—

Add a comment to a snippet discussion

POST /api/v4/projects/{id}/snippets/{noteable_id}/discussions/{discussion_id}/notes

Adds a comment to a specified snippet discussion.

Parameters

Name	Type	Description
`id` Path, required	String	ID or URL-encoded path of the project
`noteable_id` Path, required	Integer	ID of the snippet
`discussion_id` Path, required	String	ID of the discussion

Request body (application/json)

Property	Type	Description
`body` Required	String	Content of the note or reply
`created_at`	String	Date and time the note was created, in ISO 8601 format such as `2016-03-11T03:45:40Z`. Requires administrator or project/group owner rights

Responses

Code	Description	Schema
`201`	Created	APIEntitiesNote
`400`	Bad Request	—
`404`	Not Found	—

Retrieve a comment from a snippet discussion

GET /api/v4/projects/{id}/snippets/{noteable_id}/discussions/{discussion_id}/notes/{note_id}

Retrieves a specified comment from a snippet discussion.

Parameters

Name	Type	Description
`id` Path, required	String	ID or URL-encoded path of the project
`noteable_id` Path, required	Integer	ID of the snippet
`discussion_id` Path, required	String	ID of the discussion
`note_id` Path, required	Integer	ID of the discussion note

Responses

Code	Description	Schema
`200`	OK	APIEntitiesNote
`400`	Bad Request	—
`404`	Not Found	—

Update a comment in a snippet discussion

PUT /api/v4/projects/{id}/snippets/{noteable_id}/discussions/{discussion_id}/notes/{note_id}

Updates or changes the status of a specified comment in a snippet discussion.

Parameters

Name	Type	Description
`id` Path, required	String	ID or URL-encoded path of the project
`noteable_id` Path, required	Integer	ID of the snippet
`discussion_id` Path, required	String	ID of the discussion
`note_id` Path, required	Integer	ID of the discussion note

Request body (application/json)

Property	Type	Description
`body`	String	Content of the note or reply. Exactly one of `body`, `resolved` must be provided
`resolved`	Boolean	If `true`, resolves the note. If `false`, reopens the note. Exactly one of `body`, `resolved` must be provided

Responses

Code	Description	Schema
`200`	OK	APIEntitiesNote
`400`	Bad Request	—
`404`	Not Found	—

Delete a comment from a snippet discussion

DELETE /api/v4/projects/{id}/snippets/{noteable_id}/discussions/{discussion_id}/notes/{note_id}

Deletes a specified comment from a snippet discussion.

Parameters

Name	Type	Description
`id` Path, required	String	ID or URL-encoded path of the project
`noteable_id` Path, required	Integer	ID of the snippet
`discussion_id` Path, required	String	ID of the discussion
`note_id` Path, required	Integer	ID of the discussion note

Responses

Code	Description	Schema
`200`	OK	APIEntitiesNote
`400`	Bad Request	—
`404`	Not Found	—

Schemas

Objects returned by the operations above and objects nested in their request bodies.

APIEntitiesCustomAttribute

Property	Type	Description
`key`	String	Example: `foo`
`value`	String	Example: `bar`

APIEntitiesDiscussion

Property	Type	Description
`id`	String	Example: `6a9c1750b37d513a43987b574953fceb50b03ce7`
`individual_note`	Boolean	Example: `false`
`notes`	APIEntitiesNote	—
`resolvable`	Boolean	—
`resolved`	Boolean	—

APIEntitiesNote

Property	Type	Description
`author`	APIEntitiesUserBasic	—
`body`	String	Example: `Note body.`
`commands_changes`	Object	—
`commit_id`	String	Example: `7b09ce7e6f80347baf0316c8c94cdba9a0a7e91d`
`confidential`	Boolean	Example: `false`
`created_at`	String (date-time)	Example: `2022-01-31T15:10:44.988Z`
`id`	Integer (int64)	Example: `1`
`imported`	Boolean	Example: `false`
`imported_from`	String	Example: `github`
`internal`	Boolean	Example: `false`
`noteable_id`	Integer (int64)	Example: `1`
`noteable_iid`	Integer	Example: `1`
`noteable_type`	String	Example: `Issue`
`position`	Object	—
`project_id`	Integer (int64)	Example: `1`
`resolvable`	Boolean	Example: `false`
`resolved`	Boolean	Example: `false`
`resolved_at`	String (date-time)	Example: `2022-01-31T15:10:44.988Z`
`resolved_by`	APIEntitiesUserBasic	—
`suggestions`	APIEntitiesSuggestion	—
`system`	Boolean	Example: `false`
`type`	String	Example: `DiscussionNote`
`updated_at`	String (date-time)	Example: `2022-01-31T15:10:44.988Z`

APIEntitiesSuggestion

Property	Type	Description
`appliable`	Boolean	Example: `true`
`applied`	Boolean	Example: `false`
`from_content`	String	Example: `Original content`
`from_line`	Integer	Example: `1`
`id`	Integer (int64)	Example: `1`
`to_content`	String	Example: `New content`
`to_line`	Integer	Example: `1`

APIEntitiesUserBasic

Property	Type	Description
`avatar_path`	String	Example: `/user/avatar/28/The-Big-Lebowski-400-400.png`
`avatar_url`	String	Example: `https://gravatar.com/avatar/1`
`custom_attributes`	Array of APIEntitiesCustomAttribute	—
`id`	Integer (int64)	Example: `1`
`locked`	Boolean	—
`name`	String	Example: `Administrator`
`public_email`	String	Example: `john@example.com`
`state`	String	Example: `active`
`username`	String	Example: `admin`
`web_url`	String	Example: `https://gitlab.example.com/root`

List all discussions for an issue

Create an issue discussion

Retrieve a discussion for an issue

Resolve or unresolve an issue discussion

List comments in an issue discussion

Add a comment to an issue discussion

Retrieve a comment from an issue discussion

Update a comment in an issue discussion

Delete a comment from an issue discussion

List all discussions for a merge request

Create a merge request discussion

Retrieve a discussion for a merge request

Resolve or unresolve a merge request discussion

List comments in a merge request discussion

Add a comment to a merge request discussion

Retrieve a comment from a merge request discussion

Update a comment in a merge request discussion

Delete a comment from a merge request discussion

List all discussions for a commit

Create a commit discussion

Retrieve a discussion for a commit

List comments in a commit discussion

Add a comment to a commit discussion

Retrieve a comment from a commit discussion

Update a comment in a commit discussion

Delete a comment from a commit discussion

List all discussions for a snippet

Create a snippet discussion

Retrieve a discussion for a snippet

List comments in a snippet discussion

Add a comment to a snippet discussion

Retrieve a comment from a snippet discussion

Update a comment in a snippet discussion

Delete a comment from a snippet discussion

Schemas

APIEntitiesCustomAttribute

APIEntitiesDiscussion

APIEntitiesNote

APIEntitiesSuggestion

APIEntitiesUserBasic

Request trial access

Thank you

Error

Request callback

Thank you

Something went wrong

Book your sessions

Thank you

Error

Request demo

Thank you

Error

Get the PCI SSC compliance report

Thank you

Error

Request partner program details

Request received

Error