%3CLINGO-SUB%20id%3D%22lingo-sub-1180500%22%20slang%3D%22en-US%22%3EHDC%20REST%20API%20v2.0!%3C%2FLINGO-SUB%3E%3CLINGO-BODY%20id%3D%22lingo-body-1180500%22%20slang%3D%22en-US%22%3E%3CP%3EAs%20a%20part%20of%20the%20work%20to%20enable%20automatic%20driver%20delivery%20for%20everyone.%20We%20had%20to%20make%20changes%20to%20our%20API%20surface.%20As%20there%20are%20differences%20in%20the%20models%2C%20this%20would%20have%20been%20a%20breaking%20change%20for%20our%20API%20consumers.%20With%20that%20in%20mind%20you%E2%80%99ll%20see%20our%20documentation%20now%20references%20v2.0%20in%20the%20API%20paths.%3C%2FP%3E%0A%3CP%3E%26nbsp%3B%3C%2FP%3E%0A%3CP%3EE.g.%3C%2FP%3E%0A%3CP%3E%26nbsp%3B%3C%2FP%3E%0A%3CP%3E%26nbsp%3B%3C%2FP%3E%0A%3CPRE%20class%3D%22lia-code-sample%20language-markup%22%3E%3CCODE%3Ehttps%3A%2F%2Fmanage.devcenter.microsoft.com%2Fv2.0%2Fmy%2Fhardware%2Fproducts%2F%7BproductID%7D%2Fsubmissions%2F%7BsubmissionId%7D%2FshippingLabels%3C%2FCODE%3E%3C%2FPRE%3E%0A%3CP%3E%26nbsp%3B%3C%2FP%3E%0A%3CP%3E%26nbsp%3B%3C%2FP%3E%0A%3CP%3E%26nbsp%3B%3C%2FP%3E%0A%3CP%3EWe%20will%20keep%20v1.0%20up%20and%20running%20until%20%3CSTRONG%3ESeptember%201%2C%202020.%20At%20that%20time%20we%20will%20decommission%20HDC%20API%20v1.%3C%2FSTRONG%3E%3C%2FP%3E%0A%3CP%3E%26nbsp%3B%3C%2FP%3E%0A%3CP%3EFor%20most%20of%20the%20API%20surface%2C%20all%20you%20need%20do%20is%20update%20the%20version%20number%20in%20the%20path.%20Though%20note%20that%20the%3CSTRONG%3E%20following%20APIs%20have%20changes%20to%20their%20models%3C%2FSTRONG%3E%2C%20which%20will%20require%20just%20a%20bit%20more%20tweaking%3A%3C%2FP%3E%0A%3CP%3E%3CA%20href%3D%22https%3A%2F%2Fnam06.safelinks.protection.outlook.com%2F%3Furl%3Dhttps%253A%252F%252Fdocs.microsoft.com%252Fen-us%252Fwindows-hardware%252Fdrivers%252Fdashboard%252Fcreate-a-new-shipping-label%26amp%3Bdata%3D04%257C01%257Cketrem%2540microsoft.com%257C2ccd5aae59cc4172fe6d08d7abffdc0f%257C72f988bf86f141af91ab2d7cd011db47%257C1%257C0%257C637166987706426231%257CUnknown%257CTWFpbGZsb3d8eyJWIjoiMC4wLjAwMDAiLCJQIjoiV2luMzIiLCJBTiI6Ik1haWwiLCJXVCI6Mn0%253D%257C-1%26amp%3Bsdata%3DgK%252BG%252BKCCgTqhvXvKHKUEIpECAVFT%252BNvXSWcc0lqzg54%253D%26amp%3Breserved%3D0%22%20target%3D%22_blank%22%20rel%3D%22noopener%20nofollow%20noopener%20noreferrer%20noopener%20noreferrer%22%3Ehttps%3A%2F%2Fdocs.microsoft.com%2Fen-us%2Fwindows-hardware%2Fdrivers%2Fdashboard%2Fcreate-a-new-shipping-label%3C%2FA%3E%3C%2FP%3E%0A%3CP%3E%3CA%20href%3D%22https%3A%2F%2Fnam06.safelinks.protection.outlook.com%2F%3Furl%3Dhttps%253A%252F%252Fdocs.microsoft.com%252Fen-us%252Fwindows-hardware%252Fdrivers%252Fdashboard%252Fmanage-shipping-labels%26amp%3Bdata%3D04%257C01%257Cketrem%2540microsoft.com%257C2ccd5aae59cc4172fe6d08d7abffdc0f%257C72f988bf86f141af91ab2d7cd011db47%257C1%257C0%257C637166987706436191%257CUnknown%257CTWFpbGZsb3d8eyJWIjoiMC4wLjAwMDAiLCJQIjoiV2luMzIiLCJBTiI6Ik1haWwiLCJXVCI6Mn0%253D%257C-1%26amp%3Bsdata%3DkKhRjYuBqi4nqv84HJdECXDzAMVUAvdyOLiDpITg4AM%253D%26amp%3Breserved%3D0%22%20target%3D%22_blank%22%20rel%3D%22noopener%20nofollow%20noopener%20noreferrer%20noopener%20noreferrer%22%3Ehttps%3A%2F%2Fdocs.microsoft.com%2Fen-us%2Fwindows-hardware%2Fdrivers%2Fdashboard%2Fmanage-shipping-labels%3C%2FA%3E%3C%2FP%3E%0A%3CP%3E%26nbsp%3B%3C%2FP%3E%0A%3CP%3EAnd%20a%20reminder%20that%20our%20up%20to%20date%20API%20reference%20can%20be%20found%20here%3A%3C%2FP%3E%0A%3CP%3E%3CA%20href%3D%22https%3A%2F%2Fdocs.microsoft.com%2Fen-us%2Fwindows-hardware%2Fdrivers%2Fdashboard%2Fdashboard-api%22%20target%3D%22_blank%22%20rel%3D%22noopener%20noopener%20noreferrer%20noopener%20noreferrer%22%3Ehttps%3A%2F%2Fdocs.microsoft.com%2Fen-us%2Fwindows-hardware%2Fdrivers%2Fdashboard%2Fdashboard-api%3C%2FA%3E%3C%2FP%3E%3C%2FLINGO-BODY%3E
Microsoft

As a part of the work to enable automatic driver delivery for everyone. We had to make changes to our API surface. As there are differences in the models, this would have been a breaking change for our API consumers. With that in mind you’ll see our documentation now references v2.0 in the API paths.

 

E.g.

 

 

https://manage.devcenter.microsoft.com/v2.0/my/hardware/products/{productID}/submissions/{submissionId}/shippingLabels

 

 

 

We will keep v1.0 up and running until September 1, 2020. At that time we will decommission HDC API v1.

 

For most of the API surface, all you need do is update the version number in the path. Though note that the following APIs have changes to their models, which will require just a bit more tweaking:

https://docs.microsoft.com/en-us/windows-hardware/drivers/dashboard/create-a-new-shipping-label

https://docs.microsoft.com/en-us/windows-hardware/drivers/dashboard/manage-shipping-labels

 

And a reminder that our up to date API reference can be found here:

https://docs.microsoft.com/en-us/windows-hardware/drivers/dashboard/dashboard-api