Updates - List

Returns a the deltas between work item revisions

GET https://dev.azure.com/{organization}/{project}/_apis/wit/workItems/{id}/updates?api-version=7.1
GET https://dev.azure.com/{organization}/{project}/_apis/wit/workItems/{id}/updates?$top={$top}&$skip={$skip}&api-version=7.1

URI Parameters

Name In Required Type Description
id
path True

integer

int32
organization
path True

string

The name of the Azure DevOps organization.

project
path

string

Project ID or project name

api-version
query True

string

Version of the API to use. This should be set to '7.1' to use this version of the api.

$skip
query

integer

int32
$top
query

integer

int32

Responses

Name Type Description
200 OK

WorkItemUpdate[]

successful operation

Security

oauth2

Type: oauth2
Flow: accessCode
Authorization URL: https://app.vssps.visualstudio.com/oauth2/authorize&response_type=Assertion
Token URL: https://app.vssps.visualstudio.com/oauth2/token?client_assertion_type=urn:ietf:params:oauth:client-assertion-type:jwt-bearer&grant_type=urn:ietf:params:oauth:grant-type:jwt-bearer

Scopes

Name Description
vso.work Grants the ability to read work items, queries, boards, area and iterations paths, and other work item tracking related metadata. Also grants the ability to execute queries, search work items and to receive notifications about work item events via service hooks.

Examples

List of work item updates
List of work item updates (project scoped)
Paged list of work item updates

List of work item updates

Sample request

GET https://dev.azure.com/fabrikam/_apis/wit/workItems/{id}/updates?api-version=7.1

Sample response

{
  "count": 13,
  "value": [
    {
      "id": 1,
      "workItemId": 1,
      "rev": 1,
      "revisedBy": {
        "displayName": "Jamal Hartnett",
        "url": "https://vssps.dev.azure.com/fabrikam/_apis/Identities/d291b0c4-a05c-4ea6-8df1-4b41d5f39eff",
        "_links": {
          "avatar": {
            "href": "https://dev.azure.com/mseng/_apis/GraphProfile/MemberAvatars/aad.YTkzODFkODYtNTYxYS03ZDdiLWJjM2QtZDUzMjllMjM5OTAz"
          }
        },
        "id": "d291b0c4-a05c-4ea6-8df1-4b41d5f39eff",
        "uniqueName": "fabrikamfiber4@hotmail.com",
        "imageUrl": "https://dev.azure.com/fabrikam/_api/_common/identityImage?id=d291b0c4-a05c-4ea6-8df1-4b41d5f39eff",
        "descriptor": "aad.YTkzODFkODYtNTYxYS03ZDdiLWJjM2QtZDUzMjllMjM5OTAz"
      },
      "revisedDate": "2017-09-04T02:28:56.253Z",
      "fields": {
        "System.Id": {
          "newValue": 1
        },
        "System.AreaId": {
          "newValue": 2
        },
        "System.NodeName": {
          "newValue": "MyAgilePro1"
        },
        "System.AreaLevel1": {
          "newValue": "MyAgilePro1"
        },
        "System.Rev": {
          "newValue": 1
        },
        "System.AuthorizedDate": {
          "newValue": "2017-09-04T02:08:16.6Z"
        },
        "System.RevisedDate": {
          "newValue": "2017-09-04T02:28:56.253Z"
        },
        "System.IterationId": {
          "newValue": 3
        },
        "System.IterationLevel1": {
          "newValue": "MyAgilePro1"
        },
        "System.IterationLevel2": {
          "newValue": "Iteration 1"
        },
        "System.WorkItemType": {
          "newValue": "Bug"
        },
        "System.State": {
          "newValue": "New"
        },
        "System.Reason": {
          "newValue": "New"
        },
        "System.AssignedTo": {},
        "System.CreatedDate": {
          "newValue": "2017-09-04T02:08:16.6Z"
        },
        "System.CreatedBy": {
          "newValue": {
            "displayName": "Jamal Hartnett",
            "url": "https://vssps.dev.azure.com/fabrikam/_apis/Identities/d291b0c4-a05c-4ea6-8df1-4b41d5f39eff",
            "_links": {
              "avatar": {
                "href": "https://dev.azure.com/mseng/_apis/GraphProfile/MemberAvatars/aad.YTkzODFkODYtNTYxYS03ZDdiLWJjM2QtZDUzMjllMjM5OTAz"
              }
            },
            "id": "d291b0c4-a05c-4ea6-8df1-4b41d5f39eff",
            "uniqueName": "fabrikamfiber4@hotmail.com",
            "imageUrl": "https://dev.azure.com/fabrikam/_api/_common/identityImage?id=d291b0c4-a05c-4ea6-8df1-4b41d5f39eff",
            "descriptor": "aad.YTkzODFkODYtNTYxYS03ZDdiLWJjM2QtZDUzMjllMjM5OTAz"
          }
        },
        "System.ChangedDate": {
          "newValue": "2017-09-04T02:08:16.6Z"
        },
        "System.ChangedBy": {
          "newValue": {
            "displayName": "Jamal Hartnett",
            "url": "https://vssps.dev.azure.com/fabrikam/_apis/Identities/d291b0c4-a05c-4ea6-8df1-4b41d5f39eff",
            "_links": {
              "avatar": {
                "href": "https://dev.azure.com/mseng/_apis/GraphProfile/MemberAvatars/aad.YTkzODFkODYtNTYxYS03ZDdiLWJjM2QtZDUzMjllMjM5OTAz"
              }
            },
            "id": "d291b0c4-a05c-4ea6-8df1-4b41d5f39eff",
            "uniqueName": "fabrikamfiber4@hotmail.com",
            "imageUrl": "https://dev.azure.com/fabrikam/_api/_common/identityImage?id=d291b0c4-a05c-4ea6-8df1-4b41d5f39eff",
            "descriptor": "aad.YTkzODFkODYtNTYxYS03ZDdiLWJjM2QtZDUzMjllMjM5OTAz"
          }
        },
        "System.AuthorizedAs": {
          "newValue": {
            "displayName": "Jamal Hartnett",
            "url": "https://vssps.dev.azure.com/fabrikam/_apis/Identities/d291b0c4-a05c-4ea6-8df1-4b41d5f39eff",
            "_links": {
              "avatar": {
                "href": "https://dev.azure.com/mseng/_apis/GraphProfile/MemberAvatars/aad.YTkzODFkODYtNTYxYS03ZDdiLWJjM2QtZDUzMjllMjM5OTAz"
              }
            },
            "id": "d291b0c4-a05c-4ea6-8df1-4b41d5f39eff",
            "uniqueName": "fabrikamfiber4@hotmail.com",
            "imageUrl": "https://dev.azure.com/fabrikam/_api/_common/identityImage?id=d291b0c4-a05c-4ea6-8df1-4b41d5f39eff",
            "descriptor": "aad.YTkzODFkODYtNTYxYS03ZDdiLWJjM2QtZDUzMjllMjM5OTAz"
          }
        },
        "System.PersonId": {
          "newValue": 90562141
        },
        "System.Watermark": {
          "newValue": 1
        },
        "System.IsDeleted": {
          "newValue": false
        },
        "System.TeamProject": {
          "newValue": "MyAgilePro1"
        },
        "System.AreaPath": {
          "newValue": "MyAgilePro1"
        },
        "System.IterationPath": {
          "newValue": "MyAgilePro1\\Iteration 1"
        },
        "System.Title": {
          "newValue": "Bug 1"
        },
        "Microsoft.VSTS.Common.Priority": {
          "newValue": 2
        },
        "Microsoft.VSTS.Common.Severity": {
          "newValue": "3 - Medium"
        },
        "Microsoft.VSTS.Common.ValueArea": {
          "newValue": "Business"
        },
        "Microsoft.VSTS.Common.StateChangeDate": {
          "newValue": "2017-09-04T02:08:16.6Z"
        },
        "System.Tags": {
          "newValue": ""
        }
      },
      "url": "https://dev.azure.com/fabrikam/6ce954b1-ce1f-45d1-b94d-e6bf2464ba2c/_apis/wit/workItems/1/updates/1"
    },
    {
      "id": 2,
      "workItemId": 1,
      "rev": 2,
      "revisedBy": {
        "id": "764a73bf-ac8b-41d9-8dee-d4f5f0edf711",
        "name": "Jamal Hartnett <fabrikamfiber4@hotmail.com>",
        "displayName": "Jamal Hartnett",
        "uniqueName": "fabrikamfiber4@hotmail.com",
        "url": "https://vssps.dev.azure.com/fabrikam/_apis/Identities/764a73bf-ac8b-41d9-8dee-d4f5f0edf711",
        "imageUrl": "https://dev.azure.com/fabrikam/_api/_common/identityImage?id=764a73bf-ac8b-41d9-8dee-d4f5f0edf711"
      },
      "revisedDate": "2017-09-04T02:36:18.75Z",
      "fields": {
        "System.Rev": {
          "oldValue": 1,
          "newValue": 2
        },
        "System.AuthorizedDate": {
          "oldValue": "2017-09-04T02:08:16.6Z",
          "newValue": "2017-09-04T02:28:56.253Z"
        },
        "System.RevisedDate": {
          "oldValue": "2017-09-04T02:28:56.253Z",
          "newValue": "2017-09-04T02:36:18.75Z"
        },
        "System.AssignedTo": {
          "newValue": {
            "displayName": "Jamal Hartnett",
            "url": "https://vssps.dev.azure.com/fabrikam/_apis/Identities/d291b0c4-a05c-4ea6-8df1-4b41d5f39eff",
            "_links": {
              "avatar": {
                "href": "https://dev.azure.com/mseng/_apis/GraphProfile/MemberAvatars/aad.YTkzODFkODYtNTYxYS03ZDdiLWJjM2QtZDUzMjllMjM5OTAz"
              }
            },
            "id": "d291b0c4-a05c-4ea6-8df1-4b41d5f39eff",
            "uniqueName": "fabrikamfiber4@hotmail.com",
            "imageUrl": "https://dev.azure.com/fabrikam/_api/_common/identityImage?id=d291b0c4-a05c-4ea6-8df1-4b41d5f39eff",
            "descriptor": "aad.YTkzODFkODYtNTYxYS03ZDdiLWJjM2QtZDUzMjllMjM5OTAz"
          }
        },
        "System.ChangedDate": {
          "oldValue": "2017-09-04T02:08:16.6Z",
          "newValue": "2017-09-04T02:28:56.253Z"
        },
        "System.Watermark": {
          "oldValue": 1,
          "newValue": 8
        }
      },
      "url": "https://dev.azure.com/fabrikam/6ce954b1-ce1f-45d1-b94d-e6bf2464ba2c/_apis/wit/workItems/1/updates/2"
    },
    {
      "id": 3,
      "workItemId": 1,
      "rev": 2,
      "revisedBy": {
        "id": "764a73bf-ac8b-41d9-8dee-d4f5f0edf711",
        "name": "Jamal Hartnett <fabrikamfiber4@hotmail.com>",
        "displayName": "Jamal Hartnett",
        "uniqueName": "fabrikamfiber4@hotmail.com",
        "url": "https://vssps.dev.azure.com/fabrikam/_apis/Identities/764a73bf-ac8b-41d9-8dee-d4f5f0edf711",
        "imageUrl": "https://dev.azure.com/fabrikam/_api/_common/identityImage?id=764a73bf-ac8b-41d9-8dee-d4f5f0edf711"
      },
      "revisedDate": "2017-09-04T02:33:39.23Z",
      "relations": {
        "added": [
          {
            "rel": "System.LinkTypes.Hierarchy-Reverse",
            "url": "https://dev.azure.com/fabrikam/_apis/wit/workItems/2",
            "attributes": {
              "isLocked": false
            }
          }
        ]
      },
      "url": "https://dev.azure.com/fabrikam/6ce954b1-ce1f-45d1-b94d-e6bf2464ba2c/_apis/wit/workItems/1/updates/3"
    },
    {
      "id": 4,
      "workItemId": 1,
      "rev": 2,
      "revisedBy": {
        "id": "764a73bf-ac8b-41d9-8dee-d4f5f0edf711",
        "name": "Jamal Hartnett <fabrikamfiber4@hotmail.com>",
        "displayName": "Jamal Hartnett",
        "uniqueName": "fabrikamfiber4@hotmail.com",
        "url": "https://vssps.dev.azure.com/fabrikam/_apis/Identities/764a73bf-ac8b-41d9-8dee-d4f5f0edf711",
        "imageUrl": "https://dev.azure.com/fabrikam/_api/_common/identityImage?id=764a73bf-ac8b-41d9-8dee-d4f5f0edf711"
      },
      "revisedDate": "2017-09-04T02:34:48.16Z",
      "relations": {
        "removed": [
          {
            "rel": "System.LinkTypes.Hierarchy-Reverse",
            "url": "https://dev.azure.com/fabrikam/_apis/wit/workItems/2",
            "attributes": {
              "isLocked": false
            }
          }
        ]
      },
      "url": "https://dev.azure.com/fabrikam/6ce954b1-ce1f-45d1-b94d-e6bf2464ba2c/_apis/wit/workItems/1/updates/4"
    },
    {
      "id": 5,
      "workItemId": 1,
      "rev": 2,
      "revisedBy": {
        "id": "764a73bf-ac8b-41d9-8dee-d4f5f0edf711",
        "name": "Jamal Hartnett <fabrikamfiber4@hotmail.com>",
        "displayName": "Jamal Hartnett",
        "uniqueName": "fabrikamfiber4@hotmail.com",
        "url": "https://vssps.dev.azure.com/fabrikam/_apis/Identities/764a73bf-ac8b-41d9-8dee-d4f5f0edf711",
        "imageUrl": "https://dev.azure.com/fabrikam/_api/_common/identityImage?id=764a73bf-ac8b-41d9-8dee-d4f5f0edf711"
      },
      "revisedDate": "2017-09-04T02:35:05.287Z",
      "relations": {
        "added": [
          {
            "rel": "System.LinkTypes.Hierarchy-Reverse",
            "url": "https://dev.azure.com/fabrikam/_apis/wit/workItems/7",
            "attributes": {
              "isLocked": false,
              "comment": "1"
            }
          }
        ]
      },
      "url": "https://dev.azure.com/fabrikam/6ce954b1-ce1f-45d1-b94d-e6bf2464ba2c/_apis/wit/workItems/1/updates/5"
    },
    {
      "id": 6,
      "workItemId": 1,
      "rev": 3,
      "revisedBy": {
        "id": "764a73bf-ac8b-41d9-8dee-d4f5f0edf711",
        "name": "Jamal Hartnett <fabrikamfiber4@hotmail.com>",
        "displayName": "Jamal Hartnett",
        "uniqueName": "fabrikamfiber4@hotmail.com",
        "url": "https://vssps.dev.azure.com/fabrikam/_apis/Identities/764a73bf-ac8b-41d9-8dee-d4f5f0edf711",
        "imageUrl": "https://dev.azure.com/fabrikam/_api/_common/identityImage?id=764a73bf-ac8b-41d9-8dee-d4f5f0edf711"
      },
      "revisedDate": "2017-09-04T02:36:25.3Z",
      "fields": {
        "System.Rev": {
          "oldValue": 2,
          "newValue": 3
        },
        "System.AuthorizedDate": {
          "oldValue": "2017-09-04T02:28:56.253Z",
          "newValue": "2017-09-04T02:36:18.75Z"
        },
        "System.RevisedDate": {
          "oldValue": "2017-09-04T02:36:18.75Z",
          "newValue": "2017-09-04T02:36:25.3Z"
        },
        "System.IterationId": {
          "oldValue": 3,
          "newValue": 4
        },
        "System.IterationLevel2": {
          "oldValue": "Iteration 1",
          "newValue": "Iteration 2"
        },
        "System.State": {
          "oldValue": "New",
          "newValue": "Active"
        },
        "System.Reason": {
          "oldValue": "New",
          "newValue": "Approved"
        },
        "System.ChangedDate": {
          "oldValue": "2017-09-04T02:28:56.253Z",
          "newValue": "2017-09-04T02:36:18.75Z"
        },
        "System.Watermark": {
          "oldValue": 8,
          "newValue": 11
        },
        "System.IterationPath": {
          "oldValue": "MyAgilePro1\\Iteration 1",
          "newValue": "MyAgilePro1\\Iteration 2"
        },
        "Microsoft.VSTS.Common.StateChangeDate": {
          "oldValue": "2017-09-04T02:08:16.6Z",
          "newValue": "2017-09-04T02:36:18.75Z"
        },
        "Microsoft.VSTS.Common.ActivatedDate": {
          "newValue": "2017-09-04T02:36:18.75Z"
        },
        "Microsoft.VSTS.Common.ActivatedBy": {
          "newValue": {
            "displayName": "Jamal Hartnett",
            "url": "https://vssps.dev.azure.com/fabrikam/_apis/Identities/d291b0c4-a05c-4ea6-8df1-4b41d5f39eff",
            "_links": {
              "avatar": {
                "href": "https://dev.azure.com/mseng/_apis/GraphProfile/MemberAvatars/aad.YTkzODFkODYtNTYxYS03ZDdiLWJjM2QtZDUzMjllMjM5OTAz"
              }
            },
            "id": "d291b0c4-a05c-4ea6-8df1-4b41d5f39eff",
            "uniqueName": "fabrikamfiber4@hotmail.com",
            "imageUrl": "https://dev.azure.com/fabrikam/_api/_common/identityImage?id=d291b0c4-a05c-4ea6-8df1-4b41d5f39eff",
            "descriptor": "aad.YTkzODFkODYtNTYxYS03ZDdiLWJjM2QtZDUzMjllMjM5OTAz"
          }
        },
        "Microsoft.VSTS.TCM.SystemInfo": {
          "newValue": "step 2"
        },
        "Microsoft.VSTS.TCM.ReproSteps": {
          "newValue": "step 1"
        },
        "System.Tags": {
          "oldValue": "",
          "newValue": "beauty"
        }
      },
      "url": "https://dev.azure.com/fabrikam/6ce954b1-ce1f-45d1-b94d-e6bf2464ba2c/_apis/wit/workItems/1/updates/6"
    },
    {
      "id": 7,
      "workItemId": 1,
      "rev": 4,
      "revisedBy": {
        "id": "764a73bf-ac8b-41d9-8dee-d4f5f0edf711",
        "name": "Jamal Hartnett <fabrikamfiber4@hotmail.com>",
        "displayName": "Jamal Hartnett",
        "uniqueName": "fabrikamfiber4@hotmail.com",
        "url": "https://vssps.dev.azure.com/fabrikam/_apis/Identities/764a73bf-ac8b-41d9-8dee-d4f5f0edf711",
        "imageUrl": "https://dev.azure.com/fabrikam/_api/_common/identityImage?id=764a73bf-ac8b-41d9-8dee-d4f5f0edf711"
      },
      "revisedDate": "2017-09-04T02:36:41.253Z",
      "fields": {
        "System.Rev": {
          "oldValue": 3,
          "newValue": 4
        },
        "System.AuthorizedDate": {
          "oldValue": "2017-09-04T02:36:18.75Z",
          "newValue": "2017-09-04T02:36:25.3Z"
        },
        "System.RevisedDate": {
          "oldValue": "2017-09-04T02:36:25.3Z",
          "newValue": "2017-09-04T02:36:41.253Z"
        },
        "System.ChangedDate": {
          "oldValue": "2017-09-04T02:36:18.75Z",
          "newValue": "2017-09-04T02:36:25.3Z"
        },
        "System.Watermark": {
          "oldValue": 11,
          "newValue": 12
        },
        "System.History": {
          "newValue": "yeah"
        }
      },
      "url": "https://dev.azure.com/fabrikam/6ce954b1-ce1f-45d1-b94d-e6bf2464ba2c/_apis/wit/workItems/1/updates/7"
    },
    {
      "id": 8,
      "workItemId": 1,
      "rev": 5,
      "revisedBy": {
        "displayName": "Jamal Hartnett",
        "url": "https://vssps.dev.azure.com/fabrikam/_apis/Identities/d291b0c4-a05c-4ea6-8df1-4b41d5f39eff",
        "_links": {
          "avatar": {
            "href": "https://dev.azure.com/mseng/_apis/GraphProfile/MemberAvatars/aad.YTkzODFkODYtNTYxYS03ZDdiLWJjM2QtZDUzMjllMjM5OTAz"
          }
        },
        "id": "d291b0c4-a05c-4ea6-8df1-4b41d5f39eff",
        "uniqueName": "fabrikamfiber4@hotmail.com",
        "imageUrl": "https://dev.azure.com/fabrikam/_api/_common/identityImage?id=d291b0c4-a05c-4ea6-8df1-4b41d5f39eff",
        "descriptor": "aad.YTkzODFkODYtNTYxYS03ZDdiLWJjM2QtZDUzMjllMjM5OTAz"
      },
      "revisedDate": "2017-09-04T02:36:46.74Z",
      "fields": {
        "System.Rev": {
          "oldValue": 4,
          "newValue": 5
        },
        "System.AuthorizedDate": {
          "oldValue": "2017-09-04T02:36:25.3Z",
          "newValue": "2017-09-04T02:36:41.253Z"
        },
        "System.RevisedDate": {
          "oldValue": "2017-09-04T02:36:41.253Z",
          "newValue": "2017-09-04T02:36:46.74Z"
        },
        "System.ChangedDate": {
          "oldValue": "2017-09-04T02:36:25.3Z",
          "newValue": "2017-09-04T02:36:41.253Z"
        },
        "System.Watermark": {
          "oldValue": 12,
          "newValue": 13
        },
        "Microsoft.VSTS.Scheduling.StoryPoints": {
          "newValue": 3
        }
      },
      "url": "https://dev.azure.com/fabrikam/6ce954b1-ce1f-45d1-b94d-e6bf2464ba2c/_apis/wit/workItems/1/updates/8"
    },
    {
      "id": 9,
      "workItemId": 1,
      "rev": 6,
      "revisedBy": {
        "id": "764a73bf-ac8b-41d9-8dee-d4f5f0edf711",
        "name": "Jamal Hartnett <fabrikamfiber4@hotmail.com>",
        "displayName": "Jamal Hartnett",
        "uniqueName": "fabrikamfiber4@hotmail.com",
        "url": "https://vssps.dev.azure.com/fabrikam/_apis/Identities/764a73bf-ac8b-41d9-8dee-d4f5f0edf711",
        "imageUrl": "https://dev.azure.com/fabrikam/_api/_common/identityImage?id=764a73bf-ac8b-41d9-8dee-d4f5f0edf711"
      },
      "revisedDate": "2017-09-04T02:39:29.947Z",
      "fields": {
        "System.Rev": {
          "oldValue": 5,
          "newValue": 6
        },
        "System.AuthorizedDate": {
          "oldValue": "2017-09-04T02:36:41.253Z",
          "newValue": "2017-09-04T02:36:46.74Z"
        },
        "System.RevisedDate": {
          "oldValue": "2017-09-04T02:36:46.74Z",
          "newValue": "2017-09-04T02:39:29.947Z"
        },
        "System.ChangedDate": {
          "oldValue": "2017-09-04T02:36:41.253Z",
          "newValue": "2017-09-04T02:36:46.74Z"
        },
        "System.Watermark": {
          "oldValue": 13,
          "newValue": 14
        },
        "Microsoft.VSTS.Common.Activity": {
          "newValue": "Design"
        }
      },
      "url": "https://dev.azure.com/fabrikam/6ce954b1-ce1f-45d1-b94d-e6bf2464ba2c/_apis/wit/workItems/1/updates/9"
    },
    {
      "id": 10,
      "workItemId": 1,
      "rev": 7,
      "revisedBy": {
        "id": "764a73bf-ac8b-41d9-8dee-d4f5f0edf711",
        "name": "Jamal Hartnett <fabrikamfiber4@hotmail.com>",
        "displayName": "Jamal Hartnett",
        "uniqueName": "fabrikamfiber4@hotmail.com",
        "url": "https://vssps.dev.azure.com/fabrikam/_apis/Identities/764a73bf-ac8b-41d9-8dee-d4f5f0edf711",
        "imageUrl": "https://dev.azure.com/fabrikam/_api/_common/identityImage?id=764a73bf-ac8b-41d9-8dee-d4f5f0edf711"
      },
      "revisedDate": "2017-09-04T02:39:57.757Z",
      "fields": {
        "System.Rev": {
          "oldValue": 6,
          "newValue": 7
        },
        "System.AuthorizedDate": {
          "oldValue": "2017-09-04T02:36:46.74Z",
          "newValue": "2017-09-04T02:39:29.947Z"
        },
        "System.RevisedDate": {
          "oldValue": "2017-09-04T02:39:29.947Z",
          "newValue": "2017-09-04T02:39:57.757Z"
        },
        "System.ChangedDate": {
          "oldValue": "2017-09-04T02:36:46.74Z",
          "newValue": "2017-09-04T02:39:29.947Z"
        },
        "System.Watermark": {
          "oldValue": 14,
          "newValue": 15
        }
      },
      "relations": {
        "added": [
          {
            "rel": "AttachedFile",
            "url": "https://dev.azure.com/fabrikam/_apis/wit/attachments/d3cbc148-a333-487c-91f7-16b0a75f6407",
            "attributes": {
              "authorizedDate": "2017-09-04T02:39:29.947Z",
              "id": 573492,
              "resourceCreatedDate": "2017-09-04T02:39:27.337Z",
              "resourceModifiedDate": "2017-06-07T05:56:53.893Z",
              "revisedDate": "9999-01-01T00:00:00Z",
              "resourceSize": 13946,
              "name": "5.jpg"
            }
          }
        ]
      },
      "url": "https://dev.azure.com/fabrikam/6ce954b1-ce1f-45d1-b94d-e6bf2464ba2c/_apis/wit/workItems/1/updates/10"
    },
    {
      "id": 11,
      "workItemId": 1,
      "rev": 8,
      "revisedBy": {
        "id": "764a73bf-ac8b-41d9-8dee-d4f5f0edf711",
        "name": "Jamal Hartnett <fabrikamfiber4@hotmail.com>",
        "displayName": "Jamal Hartnett",
        "uniqueName": "fabrikamfiber4@hotmail.com",
        "url": "https://vssps.dev.azure.com/fabrikam/_apis/Identities/764a73bf-ac8b-41d9-8dee-d4f5f0edf711",
        "imageUrl": "https://dev.azure.com/fabrikam/_api/_common/identityImage?id=764a73bf-ac8b-41d9-8dee-d4f5f0edf711"
      },
      "revisedDate": "2017-09-04T02:43:24.21Z",
      "fields": {
        "System.Rev": {
          "oldValue": 7,
          "newValue": 8
        },
        "System.AuthorizedDate": {
          "oldValue": "2017-09-04T02:39:29.947Z",
          "newValue": "2017-09-04T02:39:57.757Z"
        },
        "System.RevisedDate": {
          "oldValue": "2017-09-04T02:39:57.757Z",
          "newValue": "2017-09-04T02:43:24.21Z"
        },
        "System.ChangedDate": {
          "oldValue": "2017-09-04T02:39:29.947Z",
          "newValue": "2017-09-04T02:39:57.757Z"
        },
        "System.Watermark": {
          "oldValue": 15,
          "newValue": 16
        }
      },
      "relations": {
        "added": [
          {
            "rel": "AttachedFile",
            "url": "https://dev.azure.com/fabrikam/_apis/wit/attachments/626b9081-5be0-4d98-a2af-52111ab732f5",
            "attributes": {
              "authorizedDate": "2017-09-04T02:39:57.757Z",
              "id": 573493,
              "resourceCreatedDate": "2017-09-04T02:39:53.157Z",
              "resourceModifiedDate": "2017-07-03T09:54:08.343Z",
              "revisedDate": "9999-01-01T00:00:00Z",
              "resourceSize": 11577,
              "name": "Book1.xlsx"
            }
          }
        ]
      },
      "url": "https://dev.azure.com/fabrikam/6ce954b1-ce1f-45d1-b94d-e6bf2464ba2c/_apis/wit/workItems/1/updates/11"
    },
    {
      "id": 12,
      "workItemId": 1,
      "rev": 8,
      "revisedBy": {
        "id": "764a73bf-ac8b-41d9-8dee-d4f5f0edf711",
        "name": "Jamal Hartnett <fabrikamfiber4@hotmail.com>",
        "displayName": "Jamal Hartnett",
        "uniqueName": "fabrikamfiber4@hotmail.com",
        "url": "https://vssps.dev.azure.com/fabrikam/_apis/Identities/764a73bf-ac8b-41d9-8dee-d4f5f0edf711",
        "imageUrl": "https://dev.azure.com/fabrikam/_api/_common/identityImage?id=764a73bf-ac8b-41d9-8dee-d4f5f0edf711"
      },
      "revisedDate": "2017-09-04T02:41:28.437Z",
      "relations": {
        "added": [
          {
            "rel": "System.LinkTypes.Related",
            "url": "https://dev.azure.com/fabrikam/_apis/wit/workItems/10",
            "attributes": {
              "isLocked": false,
              "comment": "1"
            }
          }
        ]
      },
      "url": "https://dev.azure.com/fabrikam/6ce954b1-ce1f-45d1-b94d-e6bf2464ba2c/_apis/wit/workItems/1/updates/12"
    },
    {
      "id": 13,
      "workItemId": 1,
      "rev": 9,
      "revisedBy": {
        "id": "764a73bf-ac8b-41d9-8dee-d4f5f0edf711",
        "name": "Jamal Hartnett <fabrikamfiber4@hotmail.com>",
        "displayName": "Jamal Hartnett",
        "uniqueName": "fabrikamfiber4@hotmail.com",
        "url": "https://vssps.dev.azure.com/fabrikam/_apis/Identities/764a73bf-ac8b-41d9-8dee-d4f5f0edf711",
        "imageUrl": "https://dev.azure.com/fabrikam/_api/_common/identityImage?id=764a73bf-ac8b-41d9-8dee-d4f5f0edf711"
      },
      "revisedDate": "9999-01-01T00:00:00Z",
      "fields": {
        "System.Rev": {
          "oldValue": 8,
          "newValue": 9
        },
        "System.AuthorizedDate": {
          "oldValue": "2017-09-04T02:39:57.757Z",
          "newValue": "2017-09-04T02:43:24.21Z"
        },
        "System.RevisedDate": {
          "oldValue": "2017-09-04T02:43:24.21Z",
          "newValue": "9999-01-01T00:00:00Z"
        },
        "System.ChangedDate": {
          "oldValue": "2017-09-04T02:39:57.757Z",
          "newValue": "2017-09-04T02:43:24.21Z"
        },
        "System.Watermark": {
          "oldValue": 16,
          "newValue": 18
        },
        "System.History": {
          "newValue": "Güvenlik\naçığı testi"
        },
        "Microsoft.VSTS.TCM.ReproSteps": {
          "oldValue": "step 1",
          "newValue": "<p>step 1</p><p>Güvenlik\naçığı testi</p>"
        },
        "System.Tags": {
          "oldValue": "beauty",
          "newValue": "beauty; Güvenlik açığı testi"
        }
      },
      "url": "https://dev.azure.com/fabrikam/6ce954b1-ce1f-45d1-b94d-e6bf2464ba2c/_apis/wit/workItems/1/updates/13"
    }
  ]
}

List of work item updates (project scoped)

Sample request

GET https://dev.azure.com/fabrikam/_apis/wit/workItems/{id}/updates?api-version=7.1

Sample response

{
  "count": 13,
  "value": [
    {
      "id": 1,
      "workItemId": 1,
      "rev": 1,
      "revisedBy": {
        "displayName": "Jamal Hartnett",
        "url": "https://vssps.dev.azure.com/fabrikam/_apis/Identities/d291b0c4-a05c-4ea6-8df1-4b41d5f39eff",
        "_links": {
          "avatar": {
            "href": "https://dev.azure.com/mseng/_apis/GraphProfile/MemberAvatars/aad.YTkzODFkODYtNTYxYS03ZDdiLWJjM2QtZDUzMjllMjM5OTAz"
          }
        },
        "id": "d291b0c4-a05c-4ea6-8df1-4b41d5f39eff",
        "uniqueName": "fabrikamfiber4@hotmail.com",
        "imageUrl": "https://dev.azure.com/fabrikam/_api/_common/identityImage?id=d291b0c4-a05c-4ea6-8df1-4b41d5f39eff",
        "descriptor": "aad.YTkzODFkODYtNTYxYS03ZDdiLWJjM2QtZDUzMjllMjM5OTAz"
      },
      "revisedDate": "2017-09-04T02:28:56.253Z",
      "fields": {
        "System.Id": {
          "newValue": 1
        },
        "System.AreaId": {
          "newValue": 2
        },
        "System.NodeName": {
          "newValue": "MyAgilePro1"
        },
        "System.AreaLevel1": {
          "newValue": "MyAgilePro1"
        },
        "System.Rev": {
          "newValue": 1
        },
        "System.AuthorizedDate": {
          "newValue": "2017-09-04T02:08:16.6Z"
        },
        "System.RevisedDate": {
          "newValue": "2017-09-04T02:28:56.253Z"
        },
        "System.IterationId": {
          "newValue": 3
        },
        "System.IterationLevel1": {
          "newValue": "MyAgilePro1"
        },
        "System.IterationLevel2": {
          "newValue": "Iteration 1"
        },
        "System.WorkItemType": {
          "newValue": "Bug"
        },
        "System.State": {
          "newValue": "New"
        },
        "System.Reason": {
          "newValue": "New"
        },
        "System.AssignedTo": {},
        "System.CreatedDate": {
          "newValue": "2017-09-04T02:08:16.6Z"
        },
        "System.CreatedBy": {
          "newValue": {
            "displayName": "Jamal Hartnett",
            "url": "https://vssps.dev.azure.com/fabrikam/_apis/Identities/d291b0c4-a05c-4ea6-8df1-4b41d5f39eff",
            "_links": {
              "avatar": {
                "href": "https://dev.azure.com/mseng/_apis/GraphProfile/MemberAvatars/aad.YTkzODFkODYtNTYxYS03ZDdiLWJjM2QtZDUzMjllMjM5OTAz"
              }
            },
            "id": "d291b0c4-a05c-4ea6-8df1-4b41d5f39eff",
            "uniqueName": "fabrikamfiber4@hotmail.com",
            "imageUrl": "https://dev.azure.com/fabrikam/_api/_common/identityImage?id=d291b0c4-a05c-4ea6-8df1-4b41d5f39eff",
            "descriptor": "aad.YTkzODFkODYtNTYxYS03ZDdiLWJjM2QtZDUzMjllMjM5OTAz"
          }
        },
        "System.ChangedDate": {
          "newValue": "2017-09-04T02:08:16.6Z"
        },
        "System.ChangedBy": {
          "newValue": {
            "displayName": "Jamal Hartnett",
            "url": "https://vssps.dev.azure.com/fabrikam/_apis/Identities/d291b0c4-a05c-4ea6-8df1-4b41d5f39eff",
            "_links": {
              "avatar": {
                "href": "https://dev.azure.com/mseng/_apis/GraphProfile/MemberAvatars/aad.YTkzODFkODYtNTYxYS03ZDdiLWJjM2QtZDUzMjllMjM5OTAz"
              }
            },
            "id": "d291b0c4-a05c-4ea6-8df1-4b41d5f39eff",
            "uniqueName": "fabrikamfiber4@hotmail.com",
            "imageUrl": "https://dev.azure.com/fabrikam/_api/_common/identityImage?id=d291b0c4-a05c-4ea6-8df1-4b41d5f39eff",
            "descriptor": "aad.YTkzODFkODYtNTYxYS03ZDdiLWJjM2QtZDUzMjllMjM5OTAz"
          }
        },
        "System.AuthorizedAs": {
          "newValue": {
            "displayName": "Jamal Hartnett",
            "url": "https://vssps.dev.azure.com/fabrikam/_apis/Identities/d291b0c4-a05c-4ea6-8df1-4b41d5f39eff",
            "_links": {
              "avatar": {
                "href": "https://dev.azure.com/mseng/_apis/GraphProfile/MemberAvatars/aad.YTkzODFkODYtNTYxYS03ZDdiLWJjM2QtZDUzMjllMjM5OTAz"
              }
            },
            "id": "d291b0c4-a05c-4ea6-8df1-4b41d5f39eff",
            "uniqueName": "fabrikamfiber4@hotmail.com",
            "imageUrl": "https://dev.azure.com/fabrikam/_api/_common/identityImage?id=d291b0c4-a05c-4ea6-8df1-4b41d5f39eff",
            "descriptor": "aad.YTkzODFkODYtNTYxYS03ZDdiLWJjM2QtZDUzMjllMjM5OTAz"
          }
        },
        "System.PersonId": {
          "newValue": 90562141
        },
        "System.Watermark": {
          "newValue": 1
        },
        "System.IsDeleted": {
          "newValue": false
        },
        "System.TeamProject": {
          "newValue": "MyAgilePro1"
        },
        "System.AreaPath": {
          "newValue": "MyAgilePro1"
        },
        "System.IterationPath": {
          "newValue": "MyAgilePro1\\Iteration 1"
        },
        "System.Title": {
          "newValue": "Bug 1"
        },
        "Microsoft.VSTS.Common.Priority": {
          "newValue": 2
        },
        "Microsoft.VSTS.Common.Severity": {
          "newValue": "3 - Medium"
        },
        "Microsoft.VSTS.Common.ValueArea": {
          "newValue": "Business"
        },
        "Microsoft.VSTS.Common.StateChangeDate": {
          "newValue": "2017-09-04T02:08:16.6Z"
        },
        "System.Tags": {
          "newValue": ""
        }
      },
      "url": "https://dev.azure.com/fabrikam/_apis/wit/workItems/1/updates/1"
    },
    {
      "id": 2,
      "workItemId": 1,
      "rev": 2,
      "revisedBy": {
        "id": "764a73bf-ac8b-41d9-8dee-d4f5f0edf711",
        "name": "Jamal Hartnett <fabrikamfiber4@hotmail.com>",
        "displayName": "Jamal Hartnett",
        "uniqueName": "fabrikamfiber4@hotmail.com",
        "url": "https://vssps.dev.azure.com/fabrikam/_apis/Identities/764a73bf-ac8b-41d9-8dee-d4f5f0edf711",
        "imageUrl": "https://dev.azure.com/fabrikam/_api/_common/identityImage?id=764a73bf-ac8b-41d9-8dee-d4f5f0edf711"
      },
      "revisedDate": "2017-09-04T02:36:18.75Z",
      "fields": {
        "System.Rev": {
          "oldValue": 1,
          "newValue": 2
        },
        "System.AuthorizedDate": {
          "oldValue": "2017-09-04T02:08:16.6Z",
          "newValue": "2017-09-04T02:28:56.253Z"
        },
        "System.RevisedDate": {
          "oldValue": "2017-09-04T02:28:56.253Z",
          "newValue": "2017-09-04T02:36:18.75Z"
        },
        "System.AssignedTo": {
          "newValue": {
            "displayName": "Jamal Hartnett",
            "url": "https://vssps.dev.azure.com/fabrikam/_apis/Identities/d291b0c4-a05c-4ea6-8df1-4b41d5f39eff",
            "_links": {
              "avatar": {
                "href": "https://dev.azure.com/mseng/_apis/GraphProfile/MemberAvatars/aad.YTkzODFkODYtNTYxYS03ZDdiLWJjM2QtZDUzMjllMjM5OTAz"
              }
            },
            "id": "d291b0c4-a05c-4ea6-8df1-4b41d5f39eff",
            "uniqueName": "fabrikamfiber4@hotmail.com",
            "imageUrl": "https://dev.azure.com/fabrikam/_api/_common/identityImage?id=d291b0c4-a05c-4ea6-8df1-4b41d5f39eff",
            "descriptor": "aad.YTkzODFkODYtNTYxYS03ZDdiLWJjM2QtZDUzMjllMjM5OTAz"
          }
        },
        "System.ChangedDate": {
          "oldValue": "2017-09-04T02:08:16.6Z",
          "newValue": "2017-09-04T02:28:56.253Z"
        },
        "System.Watermark": {
          "oldValue": 1,
          "newValue": 8
        }
      },
      "url": "https://dev.azure.com/fabrikam/6ce954b1-ce1f-45d1-b94d-e6bf2464ba2c/_apis/wit/workItems/1/updates/2"
    },
    {
      "id": 3,
      "workItemId": 1,
      "rev": 2,
      "revisedBy": {
        "id": "764a73bf-ac8b-41d9-8dee-d4f5f0edf711",
        "name": "Jamal Hartnett <fabrikamfiber4@hotmail.com>",
        "displayName": "Jamal Hartnett",
        "uniqueName": "fabrikamfiber4@hotmail.com",
        "url": "https://vssps.dev.azure.com/fabrikam/_apis/Identities/764a73bf-ac8b-41d9-8dee-d4f5f0edf711",
        "imageUrl": "https://dev.azure.com/fabrikam/_api/_common/identityImage?id=764a73bf-ac8b-41d9-8dee-d4f5f0edf711"
      },
      "revisedDate": "2017-09-04T02:33:39.23Z",
      "relations": {
        "added": [
          {
            "rel": "System.LinkTypes.Hierarchy-Reverse",
            "url": "https://dev.azure.com/fabrikam/_apis/wit/workItems/2",
            "attributes": {
              "isLocked": false
            }
          }
        ]
      },
      "url": "https://dev.azure.com/fabrikam/6ce954b1-ce1f-45d1-b94d-e6bf2464ba2c/_apis/wit/workItems/1/updates/3"
    },
    {
      "id": 4,
      "workItemId": 1,
      "rev": 2,
      "revisedBy": {
        "id": "764a73bf-ac8b-41d9-8dee-d4f5f0edf711",
        "name": "Jamal Hartnett <fabrikamfiber4@hotmail.com>",
        "displayName": "Jamal Hartnett",
        "uniqueName": "fabrikamfiber4@hotmail.com",
        "url": "https://vssps.dev.azure.com/fabrikam/_apis/Identities/764a73bf-ac8b-41d9-8dee-d4f5f0edf711",
        "imageUrl": "https://dev.azure.com/fabrikam/_api/_common/identityImage?id=764a73bf-ac8b-41d9-8dee-d4f5f0edf711"
      },
      "revisedDate": "2017-09-04T02:34:48.16Z",
      "relations": {
        "removed": [
          {
            "rel": "System.LinkTypes.Hierarchy-Reverse",
            "url": "https://dev.azure.com/fabrikam/_apis/wit/workItems/2",
            "attributes": {
              "isLocked": false
            }
          }
        ]
      },
      "url": "https://dev.azure.com/fabrikam/6ce954b1-ce1f-45d1-b94d-e6bf2464ba2c/_apis/wit/workItems/1/updates/4"
    },
    {
      "id": 5,
      "workItemId": 1,
      "rev": 2,
      "revisedBy": {
        "id": "764a73bf-ac8b-41d9-8dee-d4f5f0edf711",
        "name": "Jamal Hartnett <fabrikamfiber4@hotmail.com>",
        "displayName": "Jamal Hartnett",
        "uniqueName": "fabrikamfiber4@hotmail.com",
        "url": "https://vssps.dev.azure.com/fabrikam/_apis/Identities/764a73bf-ac8b-41d9-8dee-d4f5f0edf711",
        "imageUrl": "https://dev.azure.com/fabrikam/_api/_common/identityImage?id=764a73bf-ac8b-41d9-8dee-d4f5f0edf711"
      },
      "revisedDate": "2017-09-04T02:35:05.287Z",
      "relations": {
        "added": [
          {
            "rel": "System.LinkTypes.Hierarchy-Reverse",
            "url": "https://dev.azure.com/fabrikam/_apis/wit/workItems/7",
            "attributes": {
              "isLocked": false,
              "comment": "1"
            }
          }
        ]
      },
      "url": "https://dev.azure.com/fabrikam/6ce954b1-ce1f-45d1-b94d-e6bf2464ba2c/_apis/wit/workItems/1/updates/5"
    },
    {
      "id": 6,
      "workItemId": 1,
      "rev": 3,
      "revisedBy": {
        "id": "764a73bf-ac8b-41d9-8dee-d4f5f0edf711",
        "name": "Jamal Hartnett <fabrikamfiber4@hotmail.com>",
        "displayName": "Jamal Hartnett",
        "uniqueName": "fabrikamfiber4@hotmail.com",
        "url": "https://vssps.dev.azure.com/fabrikam/_apis/Identities/764a73bf-ac8b-41d9-8dee-d4f5f0edf711",
        "imageUrl": "https://dev.azure.com/fabrikam/_api/_common/identityImage?id=764a73bf-ac8b-41d9-8dee-d4f5f0edf711"
      },
      "revisedDate": "2017-09-04T02:36:25.3Z",
      "fields": {
        "System.Rev": {
          "oldValue": 2,
          "newValue": 3
        },
        "System.AuthorizedDate": {
          "oldValue": "2017-09-04T02:28:56.253Z",
          "newValue": "2017-09-04T02:36:18.75Z"
        },
        "System.RevisedDate": {
          "oldValue": "2017-09-04T02:36:18.75Z",
          "newValue": "2017-09-04T02:36:25.3Z"
        },
        "System.IterationId": {
          "oldValue": 3,
          "newValue": 4
        },
        "System.IterationLevel2": {
          "oldValue": "Iteration 1",
          "newValue": "Iteration 2"
        },
        "System.State": {
          "oldValue": "New",
          "newValue": "Active"
        },
        "System.Reason": {
          "oldValue": "New",
          "newValue": "Approved"
        },
        "System.ChangedDate": {
          "oldValue": "2017-09-04T02:28:56.253Z",
          "newValue": "2017-09-04T02:36:18.75Z"
        },
        "System.Watermark": {
          "oldValue": 8,
          "newValue": 11
        },
        "System.IterationPath": {
          "oldValue": "MyAgilePro1\\Iteration 1",
          "newValue": "MyAgilePro1\\Iteration 2"
        },
        "Microsoft.VSTS.Common.StateChangeDate": {
          "oldValue": "2017-09-04T02:08:16.6Z",
          "newValue": "2017-09-04T02:36:18.75Z"
        },
        "Microsoft.VSTS.Common.ActivatedDate": {
          "newValue": "2017-09-04T02:36:18.75Z"
        },
        "Microsoft.VSTS.Common.ActivatedBy": {
          "newValue": {
            "displayName": "Jamal Hartnett",
            "url": "https://vssps.dev.azure.com/fabrikam/_apis/Identities/d291b0c4-a05c-4ea6-8df1-4b41d5f39eff",
            "_links": {
              "avatar": {
                "href": "https://dev.azure.com/mseng/_apis/GraphProfile/MemberAvatars/aad.YTkzODFkODYtNTYxYS03ZDdiLWJjM2QtZDUzMjllMjM5OTAz"
              }
            },
            "id": "d291b0c4-a05c-4ea6-8df1-4b41d5f39eff",
            "uniqueName": "fabrikamfiber4@hotmail.com",
            "imageUrl": "https://dev.azure.com/fabrikam/_api/_common/identityImage?id=d291b0c4-a05c-4ea6-8df1-4b41d5f39eff",
            "descriptor": "aad.YTkzODFkODYtNTYxYS03ZDdiLWJjM2QtZDUzMjllMjM5OTAz"
          }
        },
        "Microsoft.VSTS.TCM.SystemInfo": {
          "newValue": "step 2"
        },
        "Microsoft.VSTS.TCM.ReproSteps": {
          "newValue": "step 1"
        },
        "System.Tags": {
          "oldValue": "",
          "newValue": "beauty"
        }
      },
      "url": "https://dev.azure.com/fabrikam/6ce954b1-ce1f-45d1-b94d-e6bf2464ba2c/_apis/wit/workItems/1/updates/6"
    },
    {
      "id": 7,
      "workItemId": 1,
      "rev": 4,
      "revisedBy": {
        "id": "764a73bf-ac8b-41d9-8dee-d4f5f0edf711",
        "name": "Jamal Hartnett <fabrikamfiber4@hotmail.com>",
        "displayName": "Jamal Hartnett",
        "uniqueName": "fabrikamfiber4@hotmail.com",
        "url": "https://vssps.dev.azure.com/fabrikam/_apis/Identities/764a73bf-ac8b-41d9-8dee-d4f5f0edf711",
        "imageUrl": "https://dev.azure.com/fabrikam/_api/_common/identityImage?id=764a73bf-ac8b-41d9-8dee-d4f5f0edf711"
      },
      "revisedDate": "2017-09-04T02:36:41.253Z",
      "fields": {
        "System.Rev": {
          "oldValue": 3,
          "newValue": 4
        },
        "System.AuthorizedDate": {
          "oldValue": "2017-09-04T02:36:18.75Z",
          "newValue": "2017-09-04T02:36:25.3Z"
        },
        "System.RevisedDate": {
          "oldValue": "2017-09-04T02:36:25.3Z",
          "newValue": "2017-09-04T02:36:41.253Z"
        },
        "System.ChangedDate": {
          "oldValue": "2017-09-04T02:36:18.75Z",
          "newValue": "2017-09-04T02:36:25.3Z"
        },
        "System.Watermark": {
          "oldValue": 11,
          "newValue": 12
        },
        "System.History": {
          "newValue": "yeah"
        }
      },
      "url": "https://dev.azure.com/fabrikam/6ce954b1-ce1f-45d1-b94d-e6bf2464ba2c/_apis/wit/workItems/1/updates/7"
    },
    {
      "id": 8,
      "workItemId": 1,
      "rev": 5,
      "revisedBy": {
        "id": "764a73bf-ac8b-41d9-8dee-d4f5f0edf711",
        "name": {
          "displayName": "Jamal Hartnett",
          "url": "https://vssps.dev.azure.com/fabrikam/_apis/Identities/d291b0c4-a05c-4ea6-8df1-4b41d5f39eff",
          "_links": {
            "avatar": {
              "href": "https://dev.azure.com/mseng/_apis/GraphProfile/MemberAvatars/aad.YTkzODFkODYtNTYxYS03ZDdiLWJjM2QtZDUzMjllMjM5OTAz"
            }
          },
          "id": "d291b0c4-a05c-4ea6-8df1-4b41d5f39eff",
          "uniqueName": "fabrikamfiber4@hotmail.com",
          "imageUrl": "https://dev.azure.com/fabrikam/_api/_common/identityImage?id=d291b0c4-a05c-4ea6-8df1-4b41d5f39eff",
          "descriptor": "aad.YTkzODFkODYtNTYxYS03ZDdiLWJjM2QtZDUzMjllMjM5OTAz"
        },
        "displayName": "Alan Wang",
        "uniqueName": "v-wanyin@microsoft.com",
        "url": "https://vssps.dev.azure.com/fabrikam/_apis/Identities/764a73bf-ac8b-41d9-8dee-d4f5f0edf711",
        "imageUrl": "https://dev.azure.com/fabrikam/_api/_common/identityImage?id=764a73bf-ac8b-41d9-8dee-d4f5f0edf711"
      },
      "revisedDate": "2017-09-04T02:36:46.74Z",
      "fields": {
        "System.Rev": {
          "oldValue": 4,
          "newValue": 5
        },
        "System.AuthorizedDate": {
          "oldValue": "2017-09-04T02:36:25.3Z",
          "newValue": "2017-09-04T02:36:41.253Z"
        },
        "System.RevisedDate": {
          "oldValue": "2017-09-04T02:36:41.253Z",
          "newValue": "2017-09-04T02:36:46.74Z"
        },
        "System.ChangedDate": {
          "oldValue": "2017-09-04T02:36:25.3Z",
          "newValue": "2017-09-04T02:36:41.253Z"
        },
        "System.Watermark": {
          "oldValue": 12,
          "newValue": 13
        },
        "Microsoft.VSTS.Scheduling.StoryPoints": {
          "newValue": 3
        }
      },
      "url": "https://dev.azure.com/fabrikam/6ce954b1-ce1f-45d1-b94d-e6bf2464ba2c/_apis/wit/workItems/1/updates/8"
    },
    {
      "id": 9,
      "workItemId": 1,
      "rev": 6,
      "revisedBy": {
        "id": "764a73bf-ac8b-41d9-8dee-d4f5f0edf711",
        "name": "Jamal Hartnett <fabrikamfiber4@hotmail.com>",
        "displayName": "Jamal Hartnett",
        "uniqueName": "fabrikamfiber4@hotmail.com",
        "url": "https://vssps.dev.azure.com/fabrikam/_apis/Identities/764a73bf-ac8b-41d9-8dee-d4f5f0edf711",
        "imageUrl": "https://dev.azure.com/fabrikam/_api/_common/identityImage?id=764a73bf-ac8b-41d9-8dee-d4f5f0edf711"
      },
      "revisedDate": "2017-09-04T02:39:29.947Z",
      "fields": {
        "System.Rev": {
          "oldValue": 5,
          "newValue": 6
        },
        "System.AuthorizedDate": {
          "oldValue": "2017-09-04T02:36:41.253Z",
          "newValue": "2017-09-04T02:36:46.74Z"
        },
        "System.RevisedDate": {
          "oldValue": "2017-09-04T02:36:46.74Z",
          "newValue": "2017-09-04T02:39:29.947Z"
        },
        "System.ChangedDate": {
          "oldValue": "2017-09-04T02:36:41.253Z",
          "newValue": "2017-09-04T02:36:46.74Z"
        },
        "System.Watermark": {
          "oldValue": 13,
          "newValue": 14
        },
        "Microsoft.VSTS.Common.Activity": {
          "newValue": "Design"
        }
      },
      "url": "https://dev.azure.com/fabrikam/6ce954b1-ce1f-45d1-b94d-e6bf2464ba2c/_apis/wit/workItems/1/updates/9"
    },
    {
      "id": 10,
      "workItemId": 1,
      "rev": 7,
      "revisedBy": {
        "id": "764a73bf-ac8b-41d9-8dee-d4f5f0edf711",
        "name": "Jamal Hartnett <fabrikamfiber4@hotmail.com>",
        "displayName": "Jamal Hartnett",
        "uniqueName": "fabrikamfiber4@hotmail.com",
        "url": "https://vssps.dev.azure.com/fabrikam/_apis/Identities/764a73bf-ac8b-41d9-8dee-d4f5f0edf711",
        "imageUrl": "https://dev.azure.com/fabrikam/_api/_common/identityImage?id=764a73bf-ac8b-41d9-8dee-d4f5f0edf711"
      },
      "revisedDate": "2017-09-04T02:39:57.757Z",
      "fields": {
        "System.Rev": {
          "oldValue": 6,
          "newValue": 7
        },
        "System.AuthorizedDate": {
          "oldValue": "2017-09-04T02:36:46.74Z",
          "newValue": "2017-09-04T02:39:29.947Z"
        },
        "System.RevisedDate": {
          "oldValue": "2017-09-04T02:39:29.947Z",
          "newValue": "2017-09-04T02:39:57.757Z"
        },
        "System.ChangedDate": {
          "oldValue": "2017-09-04T02:36:46.74Z",
          "newValue": "2017-09-04T02:39:29.947Z"
        },
        "System.Watermark": {
          "oldValue": 14,
          "newValue": 15
        }
      },
      "relations": {
        "added": [
          {
            "rel": "AttachedFile",
            "url": "https://dev.azure.com/fabrikam/_apis/wit/attachments/d3cbc148-a333-487c-91f7-16b0a75f6407",
            "attributes": {
              "authorizedDate": "2017-09-04T02:39:29.947Z",
              "id": 573492,
              "resourceCreatedDate": "2017-09-04T02:39:27.337Z",
              "resourceModifiedDate": "2017-06-07T05:56:53.893Z",
              "revisedDate": "9999-01-01T00:00:00Z",
              "resourceSize": 13946,
              "name": "5.jpg"
            }
          }
        ]
      },
      "url": "https://dev.azure.com/fabrikam/6ce954b1-ce1f-45d1-b94d-e6bf2464ba2c/_apis/wit/workItems/1/updates/10"
    },
    {
      "id": 11,
      "workItemId": 1,
      "rev": 8,
      "revisedBy": {
        "id": "764a73bf-ac8b-41d9-8dee-d4f5f0edf711",
        "name": "Jamal Hartnett <fabrikamfiber4@hotmail.com>",
        "displayName": "Jamal Hartnett",
        "uniqueName": "fabrikamfiber4@hotmail.com",
        "url": "https://vssps.dev.azure.com/fabrikam/_apis/Identities/764a73bf-ac8b-41d9-8dee-d4f5f0edf711",
        "imageUrl": "https://dev.azure.com/fabrikam/_api/_common/identityImage?id=764a73bf-ac8b-41d9-8dee-d4f5f0edf711"
      },
      "revisedDate": "2017-09-04T02:43:24.21Z",
      "fields": {
        "System.Rev": {
          "oldValue": 7,
          "newValue": 8
        },
        "System.AuthorizedDate": {
          "oldValue": "2017-09-04T02:39:29.947Z",
          "newValue": "2017-09-04T02:39:57.757Z"
        },
        "System.RevisedDate": {
          "oldValue": "2017-09-04T02:39:57.757Z",
          "newValue": "2017-09-04T02:43:24.21Z"
        },
        "System.ChangedDate": {
          "oldValue": "2017-09-04T02:39:29.947Z",
          "newValue": "2017-09-04T02:39:57.757Z"
        },
        "System.Watermark": {
          "oldValue": 15,
          "newValue": 16
        }
      },
      "relations": {
        "added": [
          {
            "rel": "AttachedFile",
            "url": "https://dev.azure.com/fabrikam/_apis/wit/attachments/626b9081-5be0-4d98-a2af-52111ab732f5",
            "attributes": {
              "authorizedDate": "2017-09-04T02:39:57.757Z",
              "id": 573493,
              "resourceCreatedDate": "2017-09-04T02:39:53.157Z",
              "resourceModifiedDate": "2017-07-03T09:54:08.343Z",
              "revisedDate": "9999-01-01T00:00:00Z",
              "resourceSize": 11577,
              "name": "Book1.xlsx"
            }
          }
        ]
      },
      "url": "https://dev.azure.com/fabrikam/6ce954b1-ce1f-45d1-b94d-e6bf2464ba2c/_apis/wit/workItems/1/updates/11"
    },
    {
      "id": 12,
      "workItemId": 1,
      "rev": 8,
      "revisedBy": {
        "id": "764a73bf-ac8b-41d9-8dee-d4f5f0edf711",
        "name": "Jamal Hartnett <fabrikamfiber4@hotmail.com>",
        "displayName": "Jamal Hartnett",
        "uniqueName": "fabrikamfiber4@hotmail.com",
        "url": "https://vssps.dev.azure.com/fabrikam/_apis/Identities/764a73bf-ac8b-41d9-8dee-d4f5f0edf711",
        "imageUrl": "https://dev.azure.com/fabrikam/_api/_common/identityImage?id=764a73bf-ac8b-41d9-8dee-d4f5f0edf711"
      },
      "revisedDate": "2017-09-04T02:41:28.437Z",
      "relations": {
        "added": [
          {
            "rel": "System.LinkTypes.Related",
            "url": "https://dev.azure.com/fabrikam/_apis/wit/workItems/10",
            "attributes": {
              "isLocked": false,
              "comment": "1"
            }
          }
        ]
      },
      "url": "https://dev.azure.com/fabrikam/6ce954b1-ce1f-45d1-b94d-e6bf2464ba2c/_apis/wit/workItems/1/updates/12"
    },
    {
      "id": 13,
      "workItemId": 1,
      "rev": 9,
      "revisedBy": {
        "id": "764a73bf-ac8b-41d9-8dee-d4f5f0edf711",
        "name": "Jamal Hartnett <fabrikamfiber4@hotmail.com>",
        "displayName": "Jamal Hartnett",
        "uniqueName": "fabrikamfiber4@hotmail.com",
        "url": "https://vssps.dev.azure.com/fabrikam/_apis/Identities/764a73bf-ac8b-41d9-8dee-d4f5f0edf711",
        "imageUrl": "https://dev.azure.com/fabrikam/_api/_common/identityImage?id=764a73bf-ac8b-41d9-8dee-d4f5f0edf711"
      },
      "revisedDate": "9999-01-01T00:00:00Z",
      "fields": {
        "System.Rev": {
          "oldValue": 8,
          "newValue": 9
        },
        "System.AuthorizedDate": {
          "oldValue": "2017-09-04T02:39:57.757Z",
          "newValue": "2017-09-04T02:43:24.21Z"
        },
        "System.RevisedDate": {
          "oldValue": "2017-09-04T02:43:24.21Z",
          "newValue": "9999-01-01T00:00:00Z"
        },
        "System.ChangedDate": {
          "oldValue": "2017-09-04T02:39:57.757Z",
          "newValue": "2017-09-04T02:43:24.21Z"
        },
        "System.Watermark": {
          "oldValue": 16,
          "newValue": 18
        },
        "System.History": {
          "newValue": "Güvenlik\naçığı testi"
        },
        "Microsoft.VSTS.TCM.ReproSteps": {
          "oldValue": "step 1",
          "newValue": "<p>step 1</p><p>Güvenlik\naçığı testi</p>"
        },
        "System.Tags": {
          "oldValue": "beauty",
          "newValue": "beauty; Güvenlik açığı testi"
        }
      },
      "url": "https://dev.azure.com/fabrikam/6ce954b1-ce1f-45d1-b94d-e6bf2464ba2c/_apis/wit/workItems/1/updates/13"
    }
  ]
}

Paged list of work item updates

Sample request

GET https://dev.azure.com/fabrikam/_apis/wit/workItems/{id}/updates?api-version=7.1

Sample response

{
  "count": 2,
  "value": [
    {
      "id": 2,
      "workItemId": 1,
      "rev": 2,
      "revisedBy": {
        "displayName": "Jamal Hartnett",
        "url": "https://vssps.dev.azure.com/fabrikam/_apis/Identities/d291b0c4-a05c-4ea6-8df1-4b41d5f39eff",
        "_links": {
          "avatar": {
            "href": "https://dev.azure.com/mseng/_apis/GraphProfile/MemberAvatars/aad.YTkzODFkODYtNTYxYS03ZDdiLWJjM2QtZDUzMjllMjM5OTAz"
          }
        },
        "id": "d291b0c4-a05c-4ea6-8df1-4b41d5f39eff",
        "uniqueName": "fabrikamfiber4@hotmail.com",
        "imageUrl": "https://dev.azure.com/fabrikam/_api/_common/identityImage?id=d291b0c4-a05c-4ea6-8df1-4b41d5f39eff",
        "descriptor": "aad.YTkzODFkODYtNTYxYS03ZDdiLWJjM2QtZDUzMjllMjM5OTAz"
      },
      "revisedDate": "2017-09-04T02:36:18.75Z",
      "fields": {
        "System.Rev": {
          "oldValue": 1,
          "newValue": 2
        },
        "System.AuthorizedDate": {
          "oldValue": "2017-09-04T02:08:16.6Z",
          "newValue": "2017-09-04T02:28:56.253Z"
        },
        "System.RevisedDate": {
          "oldValue": "2017-09-04T02:28:56.253Z",
          "newValue": "2017-09-04T02:36:18.75Z"
        },
        "System.AssignedTo": {
          "newValue": {
            "displayName": "Jamal Hartnett",
            "url": "https://vssps.dev.azure.com/fabrikam/_apis/Identities/d291b0c4-a05c-4ea6-8df1-4b41d5f39eff",
            "_links": {
              "avatar": {
                "href": "https://dev.azure.com/mseng/_apis/GraphProfile/MemberAvatars/aad.YTkzODFkODYtNTYxYS03ZDdiLWJjM2QtZDUzMjllMjM5OTAz"
              }
            },
            "id": "d291b0c4-a05c-4ea6-8df1-4b41d5f39eff",
            "uniqueName": "fabrikamfiber4@hotmail.com",
            "imageUrl": "https://dev.azure.com/fabrikam/_api/_common/identityImage?id=d291b0c4-a05c-4ea6-8df1-4b41d5f39eff",
            "descriptor": "aad.YTkzODFkODYtNTYxYS03ZDdiLWJjM2QtZDUzMjllMjM5OTAz"
          }
        },
        "System.ChangedDate": {
          "oldValue": "2017-09-04T02:08:16.6Z",
          "newValue": "2017-09-04T02:28:56.253Z"
        },
        "System.Watermark": {
          "oldValue": 1,
          "newValue": 8
        }
      },
      "url": "https://dev.azure.com/fabrikam/_apis/wit/workItems/1/updates/2"
    },
    {
      "id": 3,
      "workItemId": 1,
      "rev": 2,
      "revisedBy": {
        "id": "764a73bf-ac8b-41d9-8dee-d4f5f0edf711",
        "name": "Jamal Hartnett <fabrikamfiber4@hotmail.com>",
        "displayName": "Jamal Hartnett",
        "uniqueName": "fabrikamfiber4@hotmail.com",
        "url": "https://vssps.dev.azure.com/fabrikam/_apis/Identities/764a73bf-ac8b-41d9-8dee-d4f5f0edf711",
        "imageUrl": "https://dev.azure.com/fabrikam/_api/_common/identityImage?id=764a73bf-ac8b-41d9-8dee-d4f5f0edf711"
      },
      "revisedDate": "2017-09-04T02:33:39.23Z",
      "relations": {
        "added": [
          {
            "rel": "System.LinkTypes.Hierarchy-Reverse",
            "url": "https://dev.azure.com/fabrikam/_apis/wit/workItems/2",
            "attributes": {
              "isLocked": false
            }
          }
        ]
      },
      "url": "https://dev.azure.com/fabrikam/_apis/wit/workItems/1/updates/3"
    }
  ]
}

Definitions

Name Description
IdentityReference

Describes a reference to an identity.

ReferenceLinks

The class to represent a collection of REST reference links.

WorkItemFieldUpdate

Describes an update to a work item field.

WorkItemRelation
WorkItemRelationUpdates

Describes updates to a work item's relations.

WorkItemUpdate

Describes an update to a work item.

IdentityReference

Describes a reference to an identity.

Name Type Description
_links

ReferenceLinks

This field contains zero or more interesting links about the graph subject. These links may be invoked to obtain additional relationships or more detailed information about this graph subject.

descriptor

string

The descriptor is the primary way to reference the graph subject while the system is running. This field will uniquely identify the same graph subject across both Accounts and Organizations.

directoryAlias

string

Deprecated - Can be retrieved by querying the Graph user referenced in the "self" entry of the IdentityRef "_links" dictionary

displayName

string

This is the non-unique display name of the graph subject. To change this field, you must alter its value in the source provider.

id

string

imageUrl

string

Deprecated - Available in the "avatar" entry of the IdentityRef "_links" dictionary

inactive

boolean

Deprecated - Can be retrieved by querying the Graph membership state referenced in the "membershipState" entry of the GraphUser "_links" dictionary

isAadIdentity

boolean

Deprecated - Can be inferred from the subject type of the descriptor (Descriptor.IsAadUserType/Descriptor.IsAadGroupType)

isContainer

boolean

Deprecated - Can be inferred from the subject type of the descriptor (Descriptor.IsGroupType)

isDeletedInOrigin

boolean

name

string

Legacy back-compat property. This has been the WIT specific value from Constants. Will be hidden (but exists) on the client unless they are targeting the newest version

profileUrl

string

Deprecated - not in use in most preexisting implementations of ToIdentityRef

uniqueName

string

Deprecated - use Domain+PrincipalName instead

url

string

This url is the full route to the source resource of this graph subject.

The class to represent a collection of REST reference links.

Name Type Description
links

object

The readonly view of the links. Because Reference links are readonly, we only want to expose them as read only.

WorkItemFieldUpdate

Describes an update to a work item field.

Name Type Description
newValue

object

The new value of the field.

oldValue

object

The old value of the field.

WorkItemRelation

Name Type Description
attributes

object

Collection of link attributes.

rel

string

Relation type.

url

string

Link url.

WorkItemRelationUpdates

Describes updates to a work item's relations.

Name Type Description
added

WorkItemRelation[]

List of newly added relations.

removed

WorkItemRelation[]

List of removed relations.

updated

WorkItemRelation[]

List of updated relations.

WorkItemUpdate

Describes an update to a work item.

Name Type Description
_links

ReferenceLinks

Link references to related REST resources.

fields

<string,  WorkItemFieldUpdate>

List of updates to fields.

id

integer

ID of update.

relations

WorkItemRelationUpdates

List of updates to relations.

rev

integer

The revision number of work item update.

revisedBy

IdentityReference

Identity for the work item update.

revisedDate

string

The work item updates revision date.

url

string

workItemId

integer

The work item ID.