Work Items - List
Returns a list of work items (Maximum 200)
GET https://dev.azure.com/{organization}/{project}/_apis/wit/workitems?ids={ids}&api-version=6.1-preview.3GET https://dev.azure.com/{organization}/{project}/_apis/wit/workitems?ids={ids}&fields={fields}&asOf={asOf}&$expand={$expand}&errorPolicy={errorPolicy}&api-version=6.1-preview.3URI Parameters
| Name | In | Required | Type | Description |
|---|---|---|---|---|
|
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 '6.1-preview.3' to use this version of the api. |
|
ids
|
query | True |
string array (int32) |
The comma-separated list of requested work item ids. (Maximum 200 ids allowed). |
|
$expand
|
query |
The expand parameters for work item attributes. Possible options are { None, Relations, Fields, Links, All }. |
||
|
as
|
query |
string date-time |
AsOf UTC date time string |
|
|
error
|
query |
The flag to control error policy in a bulk get work items request. Possible options are {Fail, Omit}. |
||
|
fields
|
query |
string array (string) |
Comma-separated list of requested fields |
Responses
| Name | Type | Description |
|---|---|---|
| 200 OK |
Work |
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
Get list of work items
Sample Request
GET https://dev.azure.com/fabrikam/_apis/wit/workitems?ids=297,299,300&api-version=6.1-preview.3
Sample Response
{
"count": 3,
"value": [
{
"id": 297,
"rev": 1,
"fields": {
"System.AreaPath": "Fabrikam-Fiber-Git",
"System.TeamProject": "Fabrikam-Fiber-Git",
"System.IterationPath": "Fabrikam-Fiber-Git",
"System.WorkItemType": "Product Backlog Item",
"System.State": "New",
"System.Reason": "New backlog item",
"System.CreatedDate": "2014-12-29T20:49:20.77Z",
"System.CreatedBy": {
"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": "2014-12-29T20:49:20.77Z",
"System.ChangedBy": {
"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.Title": "Customer can sign in using their Microsoft Account",
"Microsoft.VSTS.Scheduling.Effort": 8,
"WEF_6CB513B6E70E43499D9FC94E5BBFB784_Kanban.Column": "New",
"System.Description": "Our authorization logic needs to allow for users with Microsoft accounts (formerly Live Ids) - http://msdn.microsoft.com/en-us/library/live/hh826547.aspx"
},
"url": "https://dev.azure.com/fabrikam/_apis/wit/workItems/297"
},
{
"id": 299,
"rev": 7,
"fields": {
"System.AreaPath": "Fabrikam-Fiber-Git\\Website",
"System.TeamProject": "Fabrikam-Fiber-Git",
"System.IterationPath": "Fabrikam-Fiber-Git",
"System.WorkItemType": "Task",
"System.State": "To Do",
"System.Reason": "New task",
"System.AssignedTo": {
"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.CreatedDate": "2014-12-29T20:49:21.617Z",
"System.CreatedBy": {
"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": "2014-12-29T20:49:28.74Z",
"System.ChangedBy": {
"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.Title": "JavaScript implementation for Microsoft Account",
"Microsoft.VSTS.Scheduling.RemainingWork": 4,
"System.Description": "Follow the code samples from MSDN",
"System.Tags": "Tag1; Tag2"
},
"url": "https://dev.azure.com/fabrikam/_apis/wit/workItems/299"
},
{
"id": 300,
"rev": 1,
"fields": {
"System.AreaPath": "Fabrikam-Fiber-Git",
"System.TeamProject": "Fabrikam-Fiber-Git",
"System.IterationPath": "Fabrikam-Fiber-Git",
"System.WorkItemType": "Task",
"System.State": "To Do",
"System.Reason": "New task",
"System.CreatedDate": "2014-12-29T20:49:22.103Z",
"System.CreatedBy": {
"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": "2014-12-29T20:49:22.103Z",
"System.ChangedBy": {
"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.Title": "Unit Testing for MSA login",
"Microsoft.VSTS.Scheduling.RemainingWork": 3,
"System.Description": "We need to ensure we have coverage to prevent regressions"
},
"url": "https://dev.azure.com/fabrikam/_apis/wit/workItems/300"
}
]
}Get list of work items, all expanded
Sample Request
GET https://dev.azure.com/fabrikam/_apis/wit/workitems?ids=297,299,300&$expand=all&api-version=6.1-preview.3
Sample Response
{
"count": 3,
"value": [
{
"id": 297,
"rev": 1,
"fields": {
"System.Id": 297,
"System.AreaId": 3570,
"System.AreaPath": "Fabrikam-Fiber-Git",
"System.NodeName": "Fabrikam-Fiber-Git",
"System.TeamProject": "Fabrikam-Fiber-Git",
"System.AreaLevel1": "Fabrikam-Fiber-Git",
"System.Rev": 1,
"System.AuthorizedDate": "2014-12-29T20:49:20.77Z",
"System.RevisedDate": "9999-01-01T00:00:00Z",
"System.IterationId": 3570,
"System.IterationPath": "Fabrikam-Fiber-Git",
"System.IterationLevel1": "Fabrikam-Fiber-Git",
"System.WorkItemType": "Product Backlog Item",
"System.State": "New",
"System.Reason": "New backlog item",
"System.CreatedDate": "2014-12-29T20:49:20.77Z",
"System.CreatedBy": {
"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": "2014-12-29T20:49:20.77Z",
"System.ChangedBy": {
"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": {
"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": 77331,
"System.Watermark": 607,
"System.Title": "Customer can sign in using their Microsoft Account",
"Microsoft.VSTS.Scheduling.Effort": 8,
"WEF_6CB513B6E70E43499D9FC94E5BBFB784_System.ExtensionMarker": true,
"WEF_6CB513B6E70E43499D9FC94E5BBFB784_Kanban.Column": "New",
"System.Description": "Our authorization logic needs to allow for users with Microsoft accounts (formerly Live Ids) - http://msdn.microsoft.com/en-us/library/live/hh826547.aspx"
},
"relations": [
{
"rel": "System.LinkTypes.Hierarchy-Forward",
"url": "https://dev.azure.com/fabrikam/_apis/wit/workItems/299",
"attributes": {
"isLocked": false,
"comment": "decomposition of work"
}
},
{
"rel": "System.LinkTypes.Hierarchy-Forward",
"url": "https://dev.azure.com/fabrikam/_apis/wit/workItems/300",
"attributes": {
"isLocked": false
}
},
{
"rel": "AttachedFile",
"url": "https://dev.azure.com/fabrikam/_apis/wit/attachments/098a279a-60b9-40a8-868b-b7fd00c0a439",
"attributes": {
"authorizedDate": "2014-12-29T20:49:20.77Z",
"id": 65273,
"resourceCreatedDate": "2014-12-29T20:49:20.77Z",
"resourceModifiedDate": "2014-12-29T20:49:20.77Z",
"revisedDate": "9999-01-01T00:00:00Z",
"comment": "Spec for the work",
"name": "Spec.txt"
}
}
],
"_links": {
"self": {
"href": "https://dev.azure.com/fabrikam/_apis/wit/workItems/297"
},
"workItemUpdates": {
"href": "https://dev.azure.com/fabrikam/_apis/wit/workItems/297/updates"
},
"workItemRevisions": {
"href": "https://dev.azure.com/fabrikam/_apis/wit/workItems/297/revisions"
},
"workItemHistory": {
"href": "https://dev.azure.com/fabrikam/_apis/wit/workItems/297/history"
},
"html": {
"href": "https://dev.azure.com/fabrikam/web/wi.aspx?pcguid=d81542e4-cdfa-4333-b082-1ae2d6c3ad16&id=297"
},
"workItemType": {
"href": "https://dev.azure.com/fabrikam/6ce954b1-ce1f-45d1-b94d-e6bf2464ba2c/_apis/wit/workItemTypes/Product%20Backlog%20Item"
},
"fields": {
"href": "https://dev.azure.com/fabrikam/_apis/wit/fields"
}
},
"url": "https://dev.azure.com/fabrikam/_apis/wit/workItems/297"
},
{
"id": 299,
"rev": 7,
"fields": {
"System.Id": 299,
"System.AreaId": 4486,
"System.AreaPath": "Fabrikam-Fiber-Git\\Website",
"System.NodeName": "Website",
"System.TeamProject": "Fabrikam-Fiber-Git",
"System.AreaLevel1": "Fabrikam-Fiber-Git",
"System.AreaLevel2": "Website",
"System.Rev": 7,
"System.AuthorizedDate": "2014-12-29T20:49:28.74Z",
"System.RevisedDate": "9999-01-01T00:00:00Z",
"System.IterationId": 3570,
"System.IterationPath": "Fabrikam-Fiber-Git",
"System.IterationLevel1": "Fabrikam-Fiber-Git",
"System.WorkItemType": "Task",
"System.State": "To Do",
"System.Reason": "New task",
"System.AssignedTo": "Johnnie McLeod <fabrikamfiber2@hotmail.com>",
"System.CreatedDate": "2014-12-29T20:49:21.617Z",
"System.CreatedBy": {
"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": "2014-12-29T20:49:28.74Z",
"System.ChangedBy": {
"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": {
"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": 77331,
"System.Watermark": 616,
"System.Title": "JavaScript implementation for Microsoft Account",
"Microsoft.VSTS.Scheduling.RemainingWork": 4,
"System.Description": "Follow the code samples from MSDN",
"System.Tags": "Tag1; Tag2"
},
"relations": [
{
"rel": "System.LinkTypes.Hierarchy-Reverse",
"url": "https://dev.azure.com/fabrikam/_apis/wit/workItems/297",
"attributes": {
"isLocked": false,
"comment": "decomposition of work"
}
},
{
"rel": "System.LinkTypes.Related",
"url": "https://dev.azure.com/fabrikam/_apis/wit/workItems/300",
"attributes": {
"isLocked": false,
"comment": "adding another task"
}
},
{
"rel": "Hyperlink",
"url": "http://blogs.msdn.com/b/bharry/archive/2014/05/12/a-new-api-for-visual-studio-online.aspx",
"attributes": {
"authorizedDate": "2014-12-29T20:49:27.98Z",
"id": 65275,
"resourceCreatedDate": "2014-12-29T20:49:27.98Z",
"resourceModifiedDate": "2014-12-29T20:49:27.98Z",
"revisedDate": "9999-01-01T00:00:00Z"
}
}
],
"_links": {
"self": {
"href": "https://dev.azure.com/fabrikam/_apis/wit/workItems/299"
},
"workItemUpdates": {
"href": "https://dev.azure.com/fabrikam/_apis/wit/workItems/299/updates"
},
"workItemRevisions": {
"href": "https://dev.azure.com/fabrikam/_apis/wit/workItems/299/revisions"
},
"workItemHistory": {
"href": "https://dev.azure.com/fabrikam/_apis/wit/workItems/299/history"
},
"html": {
"href": "https://dev.azure.com/fabrikam/web/wi.aspx?pcguid=d81542e4-cdfa-4333-b082-1ae2d6c3ad16&id=299"
},
"workItemType": {
"href": "https://dev.azure.com/fabrikam/6ce954b1-ce1f-45d1-b94d-e6bf2464ba2c/_apis/wit/workItemTypes/Task"
},
"fields": {
"href": "https://dev.azure.com/fabrikam/_apis/wit/fields"
}
},
"url": "https://dev.azure.com/fabrikam/_apis/wit/workItems/299"
},
{
"id": 300,
"rev": 1,
"fields": {
"System.Id": 300,
"System.AreaId": 3570,
"System.AreaPath": "Fabrikam-Fiber-Git",
"System.NodeName": "Fabrikam-Fiber-Git",
"System.TeamProject": "Fabrikam-Fiber-Git",
"System.AreaLevel1": "Fabrikam-Fiber-Git",
"System.Rev": 1,
"System.AuthorizedDate": "2014-12-29T20:49:22.103Z",
"System.RevisedDate": "9999-01-01T00:00:00Z",
"System.IterationId": 3570,
"System.IterationPath": "Fabrikam-Fiber-Git",
"System.IterationLevel1": "Fabrikam-Fiber-Git",
"System.WorkItemType": "Task",
"System.State": "To Do",
"System.Reason": "New task",
"System.CreatedDate": "2014-12-29T20:49:22.103Z",
"System.CreatedBy": {
"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": "2014-12-29T20:49:22.103Z",
"System.ChangedBy": {
"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": {
"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": 77331,
"System.Watermark": 610,
"System.Title": "Unit Testing for MSA login",
"Microsoft.VSTS.Scheduling.RemainingWork": 3,
"System.Description": "We need to ensure we have coverage to prevent regressions"
},
"relations": [
{
"rel": "System.LinkTypes.Hierarchy-Reverse",
"url": "https://dev.azure.com/fabrikam/_apis/wit/workItems/297",
"attributes": {
"isLocked": false
}
},
{
"rel": "System.LinkTypes.Related",
"url": "https://dev.azure.com/fabrikam/_apis/wit/workItems/299",
"attributes": {
"isLocked": false,
"comment": "adding another task"
}
}
],
"_links": {
"self": {
"href": "https://dev.azure.com/fabrikam/_apis/wit/workItems/300"
},
"workItemUpdates": {
"href": "https://dev.azure.com/fabrikam/_apis/wit/workItems/300/updates"
},
"workItemRevisions": {
"href": "https://dev.azure.com/fabrikam/_apis/wit/workItems/300/revisions"
},
"workItemHistory": {
"href": "https://dev.azure.com/fabrikam/_apis/wit/workItems/300/history"
},
"html": {
"href": "https://dev.azure.com/fabrikam/web/wi.aspx?pcguid=d81542e4-cdfa-4333-b082-1ae2d6c3ad16&id=300"
},
"workItemType": {
"href": "https://dev.azure.com/fabrikam/6ce954b1-ce1f-45d1-b94d-e6bf2464ba2c/_apis/wit/workItemTypes/Task"
},
"fields": {
"href": "https://dev.azure.com/fabrikam/_apis/wit/fields"
}
},
"url": "https://dev.azure.com/fabrikam/_apis/wit/workItems/300"
}
]
}Get list of work items as of specific datetime #1
Sample Request
GET https://dev.azure.com/fabrikam/_apis/wit/workitems?ids=297,299,300&fields=System.Id,System.Title,System.WorkItemType,Microsoft.VSTS.Scheduling.RemainingWork&asOf=2014-12-29T20:49:22.103Z&api-version=6.1-preview.3
Sample Response
{
"count": 3,
"value": [
{
"id": 297,
"rev": 1,
"fields": {
"System.Id": 297,
"System.WorkItemType": "Product Backlog Item",
"System.Title": "Customer can sign in using their Microsoft Account"
},
"url": "https://dev.azure.com/fabrikam/_apis/wit/workItems/297"
},
{
"id": 299,
"rev": 1,
"fields": {
"System.Id": 299,
"System.WorkItemType": "Task",
"System.Title": "JavaScript implementation for Microsoft Account",
"Microsoft.VSTS.Scheduling.RemainingWork": 4
},
"url": "https://dev.azure.com/fabrikam/_apis/wit/workItems/299"
},
{
"id": 300,
"rev": 1,
"fields": {
"System.Id": 300,
"System.WorkItemType": "Task",
"System.Title": "Unit Testing for MSA login",
"Microsoft.VSTS.Scheduling.RemainingWork": 3
},
"url": "https://dev.azure.com/fabrikam/_apis/wit/workItems/300"
}
]
}Get list of work items as of specific datetime #2
Sample Request
GET https://dev.azure.com/fabrikam/_apis/wit/workitems?ids=300,299,298,17,16,15,14,9,8&fields=System.Id,System.Title,System.State&asOf=2014-12-29T20:49:34.617Z&api-version=6.1-preview.3
Sample Response
{
"count": 9,
"value": [
{
"id": 8,
"rev": 3,
"fields": {
"System.Id": 8,
"System.State": "Done",
"System.Title": "Create UI for logging in with Live ID"
},
"url": "https://dev.azure.com/fabrikam/_apis/wit/workItems/8"
},
{
"id": 9,
"rev": 2,
"fields": {
"System.Id": 9,
"System.State": "Done",
"System.Title": "Get unit tests working in the cloud"
},
"url": "https://dev.azure.com/fabrikam/_apis/wit/workItems/9"
},
{
"id": 14,
"rev": 5,
"fields": {
"System.Id": 14,
"System.State": "Done",
"System.Title": "Design application workflow"
},
"url": "https://dev.azure.com/fabrikam/_apis/wit/workItems/14"
},
{
"id": 15,
"rev": 4,
"fields": {
"System.Id": 15,
"System.State": "In Progress",
"System.Title": "UI Implementation"
},
"url": "https://dev.azure.com/fabrikam/_apis/wit/workItems/15"
},
{
"id": 16,
"rev": 4,
"fields": {
"System.Id": 16,
"System.State": "In Progress",
"System.Title": "Write code to get GPS location and resolve to address"
},
"url": "https://dev.azure.com/fabrikam/_apis/wit/workItems/16"
},
{
"id": 17,
"rev": 4,
"fields": {
"System.Id": 17,
"System.State": "In Progress",
"System.Title": "Unit testing for feature"
},
"url": "https://dev.azure.com/fabrikam/_apis/wit/workItems/17"
},
{
"id": 298,
"rev": 1,
"fields": {
"System.Id": 298,
"System.State": "To Do",
"System.Title": "JavaScript implementation for Microsoft Account"
},
"url": "https://dev.azure.com/fabrikam/_apis/wit/workItems/298"
},
{
"id": 299,
"rev": 7,
"fields": {
"System.Id": 299,
"System.State": "To Do",
"System.Title": "JavaScript implementation for Microsoft Account"
},
"url": "https://dev.azure.com/fabrikam/_apis/wit/workItems/299"
},
{
"id": 300,
"rev": 1,
"fields": {
"System.Id": 300,
"System.State": "To Do",
"System.Title": "Unit Testing for MSA login"
},
"url": "https://dev.azure.com/fabrikam/_apis/wit/workItems/300"
}
]
}Get list of work items as of specific datetime #3
Sample Request
GET https://dev.azure.com/fabrikam/_apis/wit/workitems?ids=297,299,300&fields=System.Id,System.Links.LinkType,System.WorkItemType,System.Title,System.State&asOf=2014-12-29T20:49:35.357Z&api-version=6.1-preview.3
Sample Response
{
"count": 3,
"value": [
{
"id": 297,
"rev": 1,
"fields": {
"System.Id": 297,
"System.WorkItemType": "Product Backlog Item",
"System.State": "New",
"System.Title": "Customer can sign in using their Microsoft Account"
},
"url": "https://dev.azure.com/fabrikam/_apis/wit/workItems/297"
},
{
"id": 299,
"rev": 7,
"fields": {
"System.Id": 299,
"System.WorkItemType": "Task",
"System.State": "To Do",
"System.Title": "JavaScript implementation for Microsoft Account"
},
"url": "https://dev.azure.com/fabrikam/_apis/wit/workItems/299"
},
{
"id": 300,
"rev": 1,
"fields": {
"System.Id": 300,
"System.WorkItemType": "Task",
"System.State": "To Do",
"System.Title": "Unit Testing for MSA login"
},
"url": "https://dev.azure.com/fabrikam/_apis/wit/workItems/300"
}
]
}Get list of work items as of specific datetime #4
Sample Request
GET https://dev.azure.com/fabrikam/_apis/wit/workitems?ids=4,5,6,7,8,9,11,12,20,1,2,3,10,13,14,15,16,17,18,19,21,33,34,46,47,58,59,297,299,300,298&fields=System.Id,System.WorkItemType,System.Title,System.AssignedTo,System.State&asOf=2014-12-29T20:49:35.983Z&api-version=6.1-preview.3
Sample Response
{
"count": 31,
"value": [
{
"id": 1,
"rev": 5,
"fields": {
"System.Id": 1,
"System.WorkItemType": "Product Backlog Item",
"System.State": "Done",
"System.Title": "Technician can check on parts orders on Windows Phone"
},
"url": "https://dev.azure.com/fabrikam/_apis/wit/workItems/1"
},
{
"id": 2,
"rev": 5,
"fields": {
"System.Id": 2,
"System.WorkItemType": "Product Backlog Item",
"System.State": "Done",
"System.Title": "Technician can look for closest hardware store from Windows Phone"
},
"url": "https://dev.azure.com/fabrikam/_apis/wit/workItems/2"
},
{
"id": 3,
"rev": 5,
"fields": {
"System.Id": 3,
"System.WorkItemType": "Product Backlog Item",
"System.State": "Done",
"System.Title": "Technician can submit invoices on Windows Phone"
},
"url": "https://dev.azure.com/fabrikam/_apis/wit/workItems/3"
},
{
"id": 4,
"rev": 7,
"fields": {
"System.Id": 4,
"System.WorkItemType": "Product Backlog Item",
"System.State": "Done",
"System.Title": "Service rep can view service ticket details from the dashboard"
},
"url": "https://dev.azure.com/fabrikam/_apis/wit/workItems/4"
},
{
"id": 5,
"rev": 6,
"fields": {
"System.Id": 5,
"System.WorkItemType": "Product Backlog Item",
"System.State": "New",
"System.Title": "Customer can view service invoices online"
},
"url": "https://dev.azure.com/fabrikam/_apis/wit/workItems/5"
},
{
"id": 6,
"rev": 6,
"fields": {
"System.Id": 6,
"System.WorkItemType": "Product Backlog Item",
"System.State": "Done",
"System.Title": "Customer can pay invoices online"
},
"url": "https://dev.azure.com/fabrikam/_apis/wit/workItems/6"
},
{
"id": 7,
"rev": 6,
"fields": {
"System.Id": 7,
"System.WorkItemType": "Product Backlog Item",
"System.State": "Done",
"System.Title": "Customer can opt-in/opt-out of paper billing"
},
"url": "https://dev.azure.com/fabrikam/_apis/wit/workItems/7"
},
{
"id": 8,
"rev": 3,
"fields": {
"System.Id": 8,
"System.WorkItemType": "Task",
"System.State": "Done",
"System.AssignedTo": "Christie Church <fabrikamfiber1@hotmail.com>",
"System.Title": "Create UI for logging in with Live ID"
},
"url": "https://dev.azure.com/fabrikam/_apis/wit/workItems/8"
},
{
"id": 9,
"rev": 2,
"fields": {
"System.Id": 9,
"System.WorkItemType": "Task",
"System.State": "Done",
"System.AssignedTo": "Chuck Reinhart <fabrikamfiber3@hotmail.com>",
"System.Title": "Get unit tests working in the cloud"
},
"url": "https://dev.azure.com/fabrikam/_apis/wit/workItems/9"
},
{
"id": 10,
"rev": 8,
"fields": {
"System.Id": 10,
"System.WorkItemType": "Product Backlog Item",
"System.State": "Done",
"System.AssignedTo": {
"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.Title": "Technician can send GPS location from Windows Phone"
},
"url": "https://dev.azure.com/fabrikam/_apis/wit/workItems/10"
},
{
"id": 11,
"rev": 11,
"fields": {
"System.Id": 11,
"System.WorkItemType": "Bug",
"System.State": "Approved",
"System.AssignedTo": {
"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.Title": "Customers with Canadian addresses not displaying properly"
},
"url": "https://dev.azure.com/fabrikam/_apis/wit/workItems/11"
},
{
"id": 12,
"rev": 6,
"fields": {
"System.Id": 12,
"System.WorkItemType": "Bug",
"System.State": "Done",
"System.AssignedTo": {
"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.Title": "Header image missing from deployment folder"
},
"url": "https://dev.azure.com/fabrikam/_apis/wit/workItems/12"
},
{
"id": 13,
"rev": 3,
"fields": {
"System.Id": 13,
"System.WorkItemType": "Task",
"System.State": "Removed",
"System.AssignedTo": {
"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.Title": "Review application design with technicians"
},
"url": "https://dev.azure.com/fabrikam/_apis/wit/workItems/13"
},
{
"id": 14,
"rev": 5,
"fields": {
"System.Id": 14,
"System.WorkItemType": "Task",
"System.State": "Done",
"System.AssignedTo": {
"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.Title": "Design application workflow"
},
"url": "https://dev.azure.com/fabrikam/_apis/wit/workItems/14"
},
{
"id": 15,
"rev": 4,
"fields": {
"System.Id": 15,
"System.WorkItemType": "Task",
"System.State": "In Progress",
"System.AssignedTo": "Raisa Pokrovskaya <fabrikamfiber5@hotmail.com>",
"System.Title": "UI Implementation"
},
"url": "https://dev.azure.com/fabrikam/_apis/wit/workItems/15"
},
{
"id": 16,
"rev": 4,
"fields": {
"System.Id": 16,
"System.WorkItemType": "Task",
"System.State": "In Progress",
"System.AssignedTo": {
"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.Title": "Write code to get GPS location and resolve to address"
},
"url": "https://dev.azure.com/fabrikam/_apis/wit/workItems/16"
},
{
"id": 17,
"rev": 4,
"fields": {
"System.Id": 17,
"System.WorkItemType": "Task",
"System.State": "In Progress",
"System.AssignedTo": {
"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.Title": "Unit testing for feature"
},
"url": "https://dev.azure.com/fabrikam/_apis/wit/workItems/17"
},
{
"id": 18,
"rev": 2,
"fields": {
"System.Id": 18,
"System.WorkItemType": "Task",
"System.State": "Removed",
"System.AssignedTo": "Christie Church <fabrikamfiber1@hotmail.com>",
"System.Title": "Review feature with technician early adopters"
},
"url": "https://dev.azure.com/fabrikam/_apis/wit/workItems/18"
},
{
"id": 19,
"rev": 3,
"fields": {
"System.Id": 19,
"System.WorkItemType": "Task",
"System.State": "Removed",
"System.AssignedTo": {
"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.Title": "Automated functional testing"
},
"url": "https://dev.azure.com/fabrikam/_apis/wit/workItems/19"
},
{
"id": 20,
"rev": 3,
"fields": {
"System.Id": 20,
"System.WorkItemType": "Feature",
"System.State": "In Progress",
"System.Title": "Windows Phone Technician App"
},
"url": "https://dev.azure.com/fabrikam/_apis/wit/workItems/20"
},
{
"id": 21,
"rev": 1,
"fields": {
"System.Id": 21,
"System.WorkItemType": "Feature",
"System.State": "New",
"System.Title": "Modern Windows end user application"
},
"url": "https://dev.azure.com/fabrikam/_apis/wit/workItems/21"
},
{
"id": 33,
"rev": 5,
"fields": {
"System.Id": 33,
"System.WorkItemType": "Bug",
"System.State": "Committed",
"System.AssignedTo": "Chuck Reinhart <fabrikamfiber3@hotmail.com>",
"System.Title": "Issue with web.config; parameter not set properly"
},
"url": "https://dev.azure.com/fabrikam/_apis/wit/workItems/33"
},
{
"id": 34,
"rev": 2,
"fields": {
"System.Id": 34,
"System.WorkItemType": "Impediment",
"System.State": "Closed",
"System.Title": "testing"
},
"url": "https://dev.azure.com/fabrikam/_apis/wit/workItems/34"
},
{
"id": 46,
"rev": 1,
"fields": {
"System.Id": 46,
"System.WorkItemType": "Bug",
"System.State": "New",
"System.Title": "Chuck Reinhart, here is the test ticket you requested"
},
"url": "https://dev.azure.com/fabrikam/_apis/wit/workItems/46"
},
{
"id": 47,
"rev": 3,
"fields": {
"System.Id": 47,
"System.WorkItemType": "Product Backlog Item",
"System.State": "New",
"System.Title": "Investigate feedback issues reported from Trello"
},
"url": "https://dev.azure.com/fabrikam/_apis/wit/workItems/47"
},
{
"id": 58,
"rev": 1,
"fields": {
"System.Id": 58,
"System.WorkItemType": "Test Plan",
"System.State": "Active",
"System.AssignedTo": "Fabrikam Fiber <fabrikamfiber1@outlook.com>",
"System.Title": "NewPlan"
},
"url": "https://dev.azure.com/fabrikam/_apis/wit/workItems/58"
},
{
"id": 59,
"rev": 1,
"fields": {
"System.Id": 59,
"System.WorkItemType": "Test Suite",
"System.State": "In Progress",
"System.AssignedTo": "[DefaultCollection]\\Project Collection Service Accounts <d81542e4-cdfa-4333-b082-1ae2d6c3ad16>",
"System.Title": "NewPlan"
},
"url": "https://dev.azure.com/fabrikam/_apis/wit/workItems/59"
},
{
"id": 297,
"rev": 1,
"fields": {
"System.Id": 297,
"System.WorkItemType": "Product Backlog Item",
"System.State": "New",
"System.Title": "Customer can sign in using their Microsoft Account"
},
"url": "https://dev.azure.com/fabrikam/_apis/wit/workItems/297"
},
{
"id": 298,
"rev": 1,
"fields": {
"System.Id": 298,
"System.WorkItemType": "Task",
"System.State": "To Do",
"System.Title": "JavaScript implementation for Microsoft Account"
},
"url": "https://dev.azure.com/fabrikam/_apis/wit/workItems/298"
},
{
"id": 299,
"rev": 7,
"fields": {
"System.Id": 299,
"System.WorkItemType": "Task",
"System.State": "To Do",
"System.AssignedTo": {
"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.Title": "JavaScript implementation for Microsoft Account"
},
"url": "https://dev.azure.com/fabrikam/_apis/wit/workItems/299"
},
{
"id": 300,
"rev": 1,
"fields": {
"System.Id": 300,
"System.WorkItemType": "Task",
"System.State": "To Do",
"System.Title": "Unit Testing for MSA login"
},
"url": "https://dev.azure.com/fabrikam/_apis/wit/workItems/300"
}
]
}Get list of work items for specific fields
Sample Request
GET https://dev.azure.com/fabrikam/_apis/wit/workitems?ids=297,299,300&fields=System.Id,System.Title,System.WorkItemType,Microsoft.VSTS.Scheduling.RemainingWork&api-version=6.1-preview.3
Sample Response
{
"count": 3,
"value": [
{
"id": 297,
"rev": 1,
"fields": {
"System.Id": 297,
"System.WorkItemType": "Product Backlog Item",
"System.Title": "Customer can sign in using their Microsoft Account"
},
"url": "https://dev.azure.com/fabrikam/_apis/wit/workItems/297"
},
{
"id": 299,
"rev": 7,
"fields": {
"System.Id": 299,
"System.WorkItemType": "Task",
"System.Title": "JavaScript implementation for Microsoft Account",
"Microsoft.VSTS.Scheduling.RemainingWork": 4
},
"url": "https://dev.azure.com/fabrikam/_apis/wit/workItems/299"
},
{
"id": 300,
"rev": 1,
"fields": {
"System.Id": 300,
"System.WorkItemType": "Task",
"System.Title": "Unit Testing for MSA login",
"Microsoft.VSTS.Scheduling.RemainingWork": 3
},
"url": "https://dev.azure.com/fabrikam/_apis/wit/workItems/300"
}
]
}Definitions
| Name | Description |
|---|---|
|
Reference |
The class to represent a collection of REST reference links. |
|
Work |
Describes a work item. |
|
Work |
Represents the reference to a specific version of a comment on a Work Item. |
|
Work |
The flag to control error policy in a bulk get work items request. Possible options are {Fail, Omit}. |
|
Work |
The expand parameters for work item attributes. Possible options are { None, Relations, Fields, Links, All } |
|
Work |
ReferenceLinks
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. |
WorkItem
Describes a work item.
| Name | Type | Description |
|---|---|---|
| _links |
Link references to related REST resources. |
|
| commentVersionRef |
Reference to a specific version of the comment added/edited/deleted in this revision. |
|
| fields |
object |
Map of field and values for the work item. |
| id |
integer |
The work item ID. |
| relations |
Relations of the work item. |
|
| rev |
integer |
Revision number of the work item. |
| url |
string |
WorkItemCommentVersionRef
Represents the reference to a specific version of a comment on a Work Item.
| Name | Type | Description |
|---|---|---|
| commentId |
integer |
The id assigned to the comment. |
| createdInRevision |
integer |
[Internal] The work item revision where this comment was originally added. |
| isDeleted |
boolean |
[Internal] Specifies whether comment was deleted. |
| text |
string |
[Internal] The text of the comment. |
| url |
string |
|
| version |
integer |
The version number. |
WorkItemErrorPolicy
The flag to control error policy in a bulk get work items request. Possible options are {Fail, Omit}.
| Name | Type | Description |
|---|---|---|
| fail |
string |
Fail work error policy. |
| omit |
string |
Omit work error policy. |
WorkItemExpand
The expand parameters for work item attributes. Possible options are { None, Relations, Fields, Links, All }
| Name | Type | Description |
|---|---|---|
| all |
string |
Expands all. |
| fields |
string |
Fields work item expand. |
| links |
string |
Links work item expand. |
| none |
string |
Default behavior. |
| relations |
string |
Relations work item expand. |
WorkItemRelation
| Name | Type | Description |
|---|---|---|
| attributes |
object |
Collection of link attributes. |
| rel |
string |
Relation type. |
| url |
string |
Link url. |
Feedback
Coming soon: Throughout 2024 we will be phasing out GitHub Issues as the feedback mechanism for content and replacing it with a new feedback system. For more information see: https://aka.ms/ContentUserFeedback.
Submit and view feedback for