add_comment_to_workitem
Adds a comment to a work item in IBM Engineering Workflow Management (CCM).
Purpose
This tool adds a comment to a work item in IBM Engineering Workflow Management (CCM). The comment is associated with the current authenticated user and can optionally mention other users. Use this tool when you need to add discussion comments to work items, document decisions or updates, mention team members for notification, or provide status updates on work item progress.
Note: Necessary permissions are required to add comment to the work item
Tags: CCM | Write | Basic
Input parameters
| Parameter | Type | Required | Description | Example |
|---|---|---|---|---|
| workitem_id | string | Yes | The ID of the work item to add comment to | 12345 |
| comment | string | Yes | The comment text to add | Work completed and ready for review |
| mentions | array | No | Optional list of user IDs to mention for notification | ['bob', 'sal'] |
Output schema
| Field | Type | Description |
| commentId | string | Unique identifier for the created comment |
| workItemId | string | ID of the work item the comment was added to |
| created | string | Timestamp when comment was created (ISO 8601 format) |
Common use cases
- Adding discussion comments to work items
- Documenting decisions or implementation details
- Providing status updates on work item progress
- Mentioning team members to notify them of updates
- Recording review feedback or questions
- Adding notes about blockers or dependencies
- Communicating with stakeholders on work item activity
- Documenting test results or verification steps