migration-guide.md

title	titleSuffix	description	ms.subservice	ms.topic	ms.assetid	ms.author	author	monikerRange	ms.date
WIT Client OM to REST Migration Guide	Azure DevOps Services	Migration guide to help you migrate your code from using WIT Client OM to REST based APIs	azure-devops-ecosystem	conceptual	30272A34-2CE1-41B3-BA7A-815D69309CBE	chcomley	chcomley	azure-devops	03/28/2019

Migration guide

[!INCLUDE version-eq-azure-devops]

This guide provides information to help migrate your .NET code from using WIT Client OM to our REST-based .NET Client Libraries. The following table lists common work tracking scenarios with links to their respected API documentation.

For sample code covered in these scenarios, see the GitHub Azure DevOps WIT Client OM Migration Guide.

Common scenarios

Scenario	WIT Client OM	REST based
Get list of work items	WorkItemStore.Query	Work Items - List
Get single work item	WorkItemStore.GetWorkItem	Work Items - Get Work Item
Create new work item	WorkItem	Work Items - Create
Update existing work item	WorkItem.Fields	Work Items - Update - Update a field
Validate a work item	WorkItem.IsValid(), WorkItem.Validate()	Work Items - Update - Validate only
Create a link to an existing work item	WorkItem.WorkItemLinks.Add	Work Item - Update - Add a link
Add a comment	WorkItem.History	Work Item - Update - Update a field
Create a hyperlink	WorkItem.Links.Add()	Work Item - Update - Add a hyperlink
Add an attachment	WorkItem.Attachments.Add()	Work Item - Update - Add an attachment
Query work items using WIQL	WorkItemStore.Query()	Wiql - Query by Wiql
Run an existing query to get a list of work items	WorkItemStore.Query()	Wiql - Query by ID
Get list of work item types for your project	Category.WorkItemTypes	Work Item Types - List
Get work item type details	Category.WorkItemTypes	Work Item Types - Get
Get list of fields for a work item type	WorkItemType.FieldDefinitions	Work Item Types Field - List
Get field details	WorkItemType.FieldDefinitions	Work Item Types Field - Get

Resources

• Migrate data from Azure DevOps Server to Azure DevOps Services
• Migration guide with code samples
• Work Item Tracking REST API documentation

Support

Looking for a help on a scenario that we missed? If so, create a new issue on the migration guide project and we'll add the scenario to the repo.