v4

latestOpenAPI 3.0.1Apache 2.02026-08-016079122.3 MB
Issue comments

Get comments by IDs

Returns a paginated list of comments specified by a list of comment IDs.

This operation can be accessed anonymously.

Permissions required: Comments are returned where the user:

  • has Browse projects project permission for the project containing the comment.
  • If issue-level security is configured, issue-level security permission to view the issue.
  • If the comment has visibility restrictions, belongs to the group or has the role visibility is restricted to.
post/rest/api/2/comment/list

Query parameters

expandstring

Use expand to include additional information about comments in the response. This parameter accepts a comma-separated list. Expand options include:

  • renderedBody Returns the comment body rendered in HTML.
  • properties Returns the comment's properties.

Request body

idsinteger[] required

The list of comment IDs. A maximum of 1000 IDs can be specified.

Response

Returned if the request is successful.

isLastboolean

Whether this is the last page.

maxResultsinteger

The maximum number of items that could be returned.

nextPagestring uri

If there is another page of results, the URL of the next page.

selfstring uri

The URL of the page.

startAtinteger

The index of the first item returned.

totalinteger

The number of items returned.