Skip to content

jira issue comment list

  • Usage: jira issue comment list KEY... [flags]

List comments on one or more issues. Use it to inspect discussion history or find comment IDs before editing or deleting.

--all walks comment pages until Jira reports the last page or a rate limit interrupts pagination. ADF bodies are rendered to Markdown for human output; lossy renders are surfaced as warnings.

Pagination

--all

Walk every page until isLast

--limit <N>

Maximum comments per page; 0 uses the default

Default: 50

Execution

-p --parallelism <N>

Maximum concurrent requests (1-16)

Default: 1

Output fields

With --output json, the response envelope's data object carries these fields. Run jira agent schema for the full machine-readable schema.

Field Type Description
comments[].author object | null Jira user identity; null when Jira reports none (e.g. an anonymized author).
comments[].body object | null The native recursive ADF document, or null when Jira returned no body.
comments[].created string (date-time)
comments[].id string
comments[].update_author object | null Jira user identity; null when Jira reports none (e.g. an anonymized author).
comments[].updated string (date-time)
comments[].visibility object | null Role/group restriction; null when the comment is unrestricted.
issue.id string
issue.key string
issue.self string
pagination.isLast boolean
pagination.maxResults integer
pagination.nextCursor string
pagination.startAt integer
pagination.total integer
warnings[] object

Examples

jira issue comment list PROJ-123 # (1)!
jira issue comment list PROJ-123 --all # (2)!
jira issue comment list PROJ-123 --output=json # (3)!
  1. List the most recent comments on an issue
  2. Walk every page of comments
  3. Keep comment metadata parseable