{"id":52397,"date":"2018-09-14T13:13:59","date_gmt":"2018-09-14T21:13:59","guid":{"rendered":"https:\/\/blogs.msdn.microsoft.com\/devops\/?p=46825"},"modified":"2019-02-14T15:48:35","modified_gmt":"2019-02-14T23:48:35","slug":"announcing-new-rest-apis-for-process-customization","status":"publish","type":"post","link":"https:\/\/devblogs.microsoft.com\/devops\/announcing-new-rest-apis-for-process-customization\/","title":{"rendered":"Announcing new REST API&#8217;s for Process Customization"},"content":{"rendered":"<p>Last sprint we released a new set of REST API endpoints for process customization. In <a href=\"https:\/\/docs.microsoft.com\/en-us\/rest\/api\/vsts\/processadmin\/processes?view=vsts-rest-4.1\">version 4.1<\/a> there are 3 sets of REST API&#8217;s. Two for the inherited model and one for the Hosted XML model. This created some confusion on what endpoints to use and when. In the new <a href=\"https:\/\/docs.microsoft.com\/en-us\/rest\/api\/vsts\/processadmin\/processes?view=vsts-rest-5.0\">5.0 (preview) version<\/a> we combined the two inherited REST API&#8217;s under a single domain. Making it much easier to determine what REST API endpoints to use. What domain you need depends on the process model used by your projects.<\/p>\n<p><strong>Work Item Tracking Process<\/strong>\nFor processes using the Inheritance model. API&#8217;s for everything you need to create and manage a process through code. This includes work item types, pages, groups, fields, states, rules, etc.<\/p>\n<p><strong>Work Item Tracking Process Template<\/strong>\nFor Hosted XML processes. API&#8217;s for checking to see if the process exists, importing, and exporting a Hosted XML process.<\/p>\n<h3>Examples<\/h3>\n<p>The new process REST API&#8217;s are also rolled into the latest version of the client libraries (<a href=\"https:\/\/www.nuget.org\/packages\/Microsoft.TeamFoundationServer.Client\/16.139.0-preview\" target=\"_new\">version 16.139.0-preview). We started to create a <\/a><a href=\"https:\/\/github.com\/Microsoft\/vsts-dotnet-samples\/tree\/master\/ClientLibrary\/Snippets\/Microsoft.TeamServices.Samples.Client\/WorkItemTrackingProcess\" target=\"_new\">few samples<\/a><a href=\"https:\/\/www.nuget.org\/packages\/Microsoft.TeamFoundationServer.Client\/16.139.0-preview\" target=\"_new\"> on our <\/a><a href=\"https:\/\/github.com\/Microsoft\/vsts-dotnet-samples\" target=\"_new\">GitHub Samples repo<\/a><a href=\"https:\/\/www.nuget.org\/packages\/Microsoft.TeamFoundationServer.Client\/16.139.0-preview\" target=\"_new\">. <\/a><\/p>\n<p><img decoding=\"async\" class=\"aligncenter size-full wp-image-46835\" src=\"https:\/\/devblogs.microsoft.com\/wp-content\/uploads\/sites\/6\/2019\/05\/process-rest-api-samples.png\" alt=\"\" width=\"1005\" height=\"752\" \/><\/p>\n<p>There are only a few examples created at the moment but we plan to add more every week or two. If you are passionate about Process REST API samples and have some extra time, please go ahead and contribute \ud83d\ude42 . Or <a href=\"https:\/\/github.com\/Microsoft\/vsts-dotnet-samples\/issues\" target=\"_new\">create an issue<\/a> to help us prioritize what samples to work on next.<\/p>\n<p>If you have any questions on how to use the new process REST API&#8217;s or client libraries, please email me directly at <a href=\"mailto:dahellem@microsoft.com\">dahellem@microsoft.com<\/a><\/p>\n<h3>Resources<\/h3>\n<ul>\n<li><a href=\"https:\/\/docs.microsoft.com\/en-us\/rest\/api\/vsts\/?view=vsts-rest-5.0\">Full REST API Documentation<\/a><\/li>\n<li><a href=\"https:\/\/docs.microsoft.com\/en-us\/azure\/devops\/integrate\/concepts\/dotnet-client-libraries?view=vsts\" target=\"_new\">.NET client libraries for Azure DevOps Sevices and TFS<\/a><\/li>\n<li><a href=\"https:\/\/www.nuget.org\/packages\/Microsoft.TeamFoundationServer.Client\/16.139.0-preview\" target=\"_new\">Microsoft Team Foundation Server Client version 16.139.0-preview Nuget Package<\/a><\/li>\n<li><a href=\"https:\/\/github.com\/Microsoft\/vsts-dotnet-samples\" target=\"_new\">Samples on GitHub<\/a><\/li>\n<li><a href=\"https:\/\/github.com\/Microsoft\/vsts-import-process-sample\" target=\"_new\">Example Importing and Exporting a Hosted XML process<\/a><\/li>\n<\/ul>\n","protected":false},"excerpt":{"rendered":"<p>In the new 5.0 (preview) version we combined the two inherited REST API&#8217;s under a single domain. Making it much easier to determine what REST API endpoints to use. What domain you need depends on the process model used by your projects.<\/p>\n","protected":false},"author":921,"featured_media":52608,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"footnotes":""},"categories":[227,1],"tags":[],"class_list":["post-52397","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-agile","category-devops"],"acf":[],"blog_post_summary":"<p>In the new 5.0 (preview) version we combined the two inherited REST API&#8217;s under a single domain. Making it much easier to determine what REST API endpoints to use. What domain you need depends on the process model used by your projects.<\/p>\n","_links":{"self":[{"href":"https:\/\/devblogs.microsoft.com\/devops\/wp-json\/wp\/v2\/posts\/52397","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/devblogs.microsoft.com\/devops\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/devblogs.microsoft.com\/devops\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/devops\/wp-json\/wp\/v2\/users\/921"}],"replies":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/devops\/wp-json\/wp\/v2\/comments?post=52397"}],"version-history":[{"count":0,"href":"https:\/\/devblogs.microsoft.com\/devops\/wp-json\/wp\/v2\/posts\/52397\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/devops\/wp-json\/wp\/v2\/media\/52608"}],"wp:attachment":[{"href":"https:\/\/devblogs.microsoft.com\/devops\/wp-json\/wp\/v2\/media?parent=52397"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/devops\/wp-json\/wp\/v2\/categories?post=52397"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/devops\/wp-json\/wp\/v2\/tags?post=52397"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}