Project workspace

list-work-item-comments-tool

Read the comment thread on a work item, newest first.

Returns the comment thread on a single work item. Comments are sorted newest first.

Inputs

NameTypeRequiredDescription
work_item_keystringyesIssue key of the work item (e.g. ACM-123).
limitintegernoCap on returned comments, 1–200. Defaults to all comments.

Permissions

  • project_management::view_backlog.

Example

{
  "work_item_key": "ACM-123",
  "limit": 50
}

Response

{
  "work_item": { "id": 42, "issue_key": "ACM-123", "title": "Stripe SDK upgrade" },
  "data": [
    {
      "id": 9001,
      "body": "Shipping after standup.",
      "body_markdown": "Shipping after standup.",
      "author": { "id": 18, "name": "Pia Nielsen", "email": "pia@example.com" },
      "created_at": "2026-05-18T15:22:55+00:00",
      "updated_at": "2026-05-18T15:22:55+00:00"
    }
  ],
  "total": 1
}

Errors

  • An unknown work_item_key returns a validation error.
  • A caller without project_management::view_backlog receives an authorization error.

On this page