add_work_item_comment
Enables users to add a comment to a work item in Azure DevOps, documenting feedback, decisions, or context. Comments are permanent, attributed to the user, and support markdown formatting.
Instructions
Adds a new comment to a work item.
Use this tool when you need to:
- Provide feedback or clarification on a work item
- Document decisions made about the work
- Add context without changing the work item's fields
- Communicate with team members about specific tasks
IMPORTANT: Comments in Azure DevOps become part of the permanent work
item history and cannot be edited or deleted after they are added. The
comment will be attributed to the user associated with the Personal
Access Token used for authentication.
Args:
id: The work item ID
text: The text of the comment (supports markdown formatting)
project: Optional project name. If not provided, will be
determined from the work item.
Returns:
Formatted string containing confirmation and the added comment with
author information and timestamp
Input Schema
Name | Required | Description | Default |
---|---|---|---|
id | Yes | ||
project | No | ||
text | Yes |
Input Schema (JSON Schema)
{
"properties": {
"id": {
"title": "Id",
"type": "integer"
},
"project": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Project"
},
"text": {
"title": "Text",
"type": "string"
}
},
"required": [
"id",
"text"
],
"title": "add_work_item_commentArguments",
"type": "object"
}