Show work item revision history
Retrieves and displays the complete revision history of a work item, showing all changes made over time.
/plugin marketplace add JoshuaRamirez/ms-ado-az-claude-code-plugin/plugin install ado-work-items@ms-ado-azitems/View the complete revision history of a work item, showing what changed, when, and by whom.
Ask user for the work item ID, then retrieve the revision history.
az devops invoke \
--area wit \
--resource revisions \
--route-parameters project={PROJECT} id={ID} \
--api-version 7.1 \
-o json
Note: The project parameter should match your configured project. You can check it with az devops configure --list.
The API returns an array of revisions, each containing:
rev - Revision number (1 is the original creation)fields.System.ChangedDate - When the change was madefields.System.ChangedBy - Who made the changePresent the revision history in a clear format:
Work Item #{ID} - Revision History
==================================
Revision #3 | 2024-01-15 14:30:00 | Changed by: Jane Smith
- State: Active -> Resolved
- AssignedTo: John Doe -> Jane Smith
Revision #2 | 2024-01-14 10:15:00 | Changed by: John Doe
- Priority: 2 -> 1
- Tags: (none) -> urgent,production
Revision #1 | 2024-01-13 09:00:00 | Created by: John Doe
- Title: Fix login button
- Type: Bug
- State: New
- Priority: 2
To identify what changed between revisions, compare the field values across consecutive revisions. Key fields to track:
| Field | Description |
|---|---|
| System.State | Work item state transitions |
| System.AssignedTo | Assignment changes |
| System.Title | Title edits |
| System.Description | Description updates |
| System.Tags | Tag additions/removals |
| System.IterationPath | Sprint/iteration changes |
| System.AreaPath | Area path changes |
| Microsoft.VSTS.Common.Priority | Priority changes |
| Microsoft.VSTS.Common.Severity | Severity changes (bugs) |
| Microsoft.VSTS.Scheduling.StoryPoints | Story point adjustments |
To view the work item as it was at a specific revision:
az devops invoke \
--area wit \
--resource revisions \
--route-parameters project={PROJECT} id={ID} revisionNumber={REV} \
--api-version 7.1 \
-o json
To find the current (latest) revision number, use the standard show command:
az boards work-item show --id {ID} --fields "System.Rev" -o json
The rev field in the response indicates the current revision number.
Show only the last N revisions by examining the returned array.
Filter changes to focus on System.State field changes to see the workflow history.
Look through revisions to identify when and who changed a particular field.
Use revision history for compliance or debugging to understand how an item evolved.