Add retryUpload API and deprecate reupload API (#28345)

11fps · web-flow · commit 72948ac9a2cb · 2026-03-24T09:24:18.000+03:00
* Add retryUpload API and deprecate reupload API
diff --git a/api-reference/beta/api/cloudpcdeviceimage-retryupload.md b/api-reference/beta/api/cloudpcdeviceimage-retryupload.md
@@ -0,0 +1,77 @@
+---
+title: "cloudPcDeviceImage: retryUpload"
+description: "Retry the upload of a cloudPcDeviceImage object that previously failed."
+author: "11fps"
+ms.localizationpriority: medium
+ms.subservice: "cloud-pc"
+doc_type: apiPageType
+ms.date: 02/25/2026
+---
+
+# cloudPcDeviceImage: retryUpload
+
+Namespace: microsoft.graph
+
+[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
+
+Retry the upload of a [cloudPcDeviceImage](../resources/cloudpcdeviceimage.md) object that previously failed.
+
+[!INCLUDE [national-cloud-support](../../includes/global-us.md)]
+
+## Permissions
+
+Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions [only if your app requires it](/graph/permissions-overview#best-practices-for-using-microsoft-graph-permissions). For details about delegated and application permissions, see [Permission types](/graph/permissions-overview#permission-types). To learn more about these permissions, see the [permissions reference](/graph/permissions-reference).
+
+<!-- { "blockType": "permissions", "name": "cloudpcdeviceimage_retryupload" } -->
+[!INCLUDE [permissions-table](../includes/permissions/cloudpcdeviceimage-retryupload-permissions.md)]
+
+## HTTP request
+
+<!-- {
+  "blockType": "ignored"
+}
+-->
+
+``` http
+POST /deviceManagement/virtualEndpoint/deviceImages/{cloudPcDeviceImageId}/retryUpload
+```
+
+## Request headers
+
+|Name|Description|
+|:---|:---|
+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
+
+## Request body
+
+Don't supply a request body for this method.
+
+## Response
+
+If successful, this method returns a `204 No Content` response code.
+
+## Examples
+
+### Request
+The following example shows a request.
+<!-- {
+  "blockType": "request",
+  "name": "retryupload_deviceimages_from_virtualendpoint"
+}
+-->
+
+``` http
+POST https://graph.microsoft.com/beta/deviceManagement/virtualEndpoint/deviceImages/594e2046-2a4f-43d3-829c-be36bb984f11/retryUpload
+```
+
+### Response
+The following example shows the response.
+<!-- {
+  "blockType": "response",
+  "truncated": true
+}
+-->
+
+``` http
+HTTP/1.1 204 No Content
+```
diff --git a/api-reference/beta/api/cloudpcdeviceimage-reupload.md b/api-reference/beta/api/cloudpcdeviceimage-reupload.md
@@ -1,21 +1,24 @@
 ---
-title: "cloudPcDeviceImage: reupload"
+title: "cloudPcDeviceImage: reupload (deprecated)"
 description: "Reupload a cloudPcDeviceImage object."
 author: "RuiHou105"
 ms.localizationpriority: medium
 ms.subservice: "cloud-pc"
 doc_type: apiPageType
-ms.date: 04/04/2024
+ms.date: 02/25/2026
 ---
 
-# cloudPcDeviceImage: reupload
+# cloudPcDeviceImage: reupload (deprecated)
 
 Namespace: microsoft.graph
 
 [!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
 
 Reupload a [cloudPcDeviceImage](../resources/cloudpcdeviceimage.md) object that failed to upload.
 
+> [!CAUTION]
+> This API is deprecated and will stop returning data on June 25, 2026. Going forward, use the [cloudPcDeviceImage: retryUpload](cloudpcdeviceimage-retryupload.md) API instead.
+
 [!INCLUDE [national-cloud-support](../../includes/global-us.md)]
 
 ## Permissions
diff --git a/api-reference/beta/includes/permissions/cloudpcdeviceimage-retryupload-permissions.md b/api-reference/beta/includes/permissions/cloudpcdeviceimage-retryupload-permissions.md
@@ -0,0 +1,11 @@
+---
+description: "Automatically generated file. DO NOT MODIFY"
+ms.topic: include
+ms.localizationpriority: medium
+---
+
+|Permission type|Least privileged permissions|Higher privileged permissions|
+|:---|:---|:---|
+|Delegated (work or school account)|CloudPC.ReadWrite.All|Not available.|
+|Delegated (personal Microsoft account)|Not supported.|Not supported.|
+|Application|CloudPC.ReadWrite.All|Not available.|
diff --git a/api-reference/beta/resources/cloudpc-api-overview.md b/api-reference/beta/resources/cloudpc-api-overview.md
@@ -33,13 +33,15 @@ Microsoft Graph controls access to resources via permissions. As a developer, yo
 |:---|:---|:---|
 |List, get, create, update, delete, or assign provisioning policies.|[cloudPcProvisioningPolicy](../resources/cloudpcprovisioningpolicy.md)|[Provisioning overview](/windows-365/enterprise/provisioning)|
 |Manage Cloud PCs including reprovision, end Cloud PC grace period, bulk reprovision, and resize Cloud PCs.|[cloudPC](../resources/cloudpc.md)|[Cloud PCs lifecycle](/windows-365/enterprise/lifecycle)|
-|List, get, create, delete, get source images, and reupload Cloud PC OS images.|[cloudPCDeviceImage](../resources/cloudpcdeviceimage.md)|[Device images overview](/windows-365/enterprise/device-images)|
+|List, get, create, delete, get source images, and retry the upload* of Cloud PC operating system images.|[cloudPCDeviceImage](../resources/cloudpcdeviceimage.md)|[Device images overview](/windows-365/enterprise/device-images)|
 |List and get gallery images.|[cloudPcGalleryImage](../resources/cloudpcgalleryimage.md)|[Gallery images overview](/windows-365/enterprise/device-images)|
 |List, get, create, update delete, update AD domain password, and run health checks for Azure network connections.|[cloudPcOnPremisesConnection](../resources/cloudpconpremisesconnection.md)|[On-premises network connection overview](/windows-365/enterprise/on-premises-network-connections)|
 |List audit events for Cloud PCs, get a specific audit event, and get audit activity types.|[cloudPcAuditEvent](../resources/cloudpcauditevent.md)|[Get Cloud PC audit logs](/windows-365/enterprise/get-cloud-pc-audit-logs-using-powershell)|
 |List, get, create, update, delete or assign user settings.|[cloudPcUserSetting](../resources/cloudpcusersetting.md)|[User settings overview](../resources/cloudpcusersetting.md)|
 |Set up rules to alert issues on the Microsoft Endpoint Manager admin center with provisioning Cloud PCs, uploading Cloud PC images, and checking Azure network connections.|[alertRecord](devicemanagement-alertrecord.md), [alertRule](devicemanagement-alertrule.md) | [Alert monitoring API](devicemanagement-monitoring.md) |
 
+> **Note**: * The [cloudPcDeviceImage: reupload](/graph/api/cloudpcdeviceimage-reupload?view=graph-rest-beta&preserve-view=true) API is deprecated and will stop returning data on June 25, 2026. Going forward, use the [cloudPcDeviceImage: retryUpload](/graph/api/cloudpcdeviceimage-retryupload?view=graph-rest-beta&preserve-view=true) API instead.
+
 ## Next steps
 - Check out the [overview for Windows 365 Cloud PC on Microsoft Graph](/graph/cloudpc-concept-overview).
 - Try out the Windows 365 Cloud PCs APIs by using the [Microsoft Graph Explorer](https://developer.microsoft.com/graph/graph-explorer).
diff --git a/api-reference/beta/resources/cloudpcdeviceimage.md b/api-reference/beta/resources/cloudpcdeviceimage.md
@@ -25,7 +25,8 @@ Represents the image resource on a Cloud PC.
 |[Create](../api/virtualendpoint-post-deviceimages.md)|[cloudPcDeviceImage](../resources/cloudpcdeviceimage.md)|Create a new [cloudPcDeviceImage](../resources/cloudpcdeviceimage.md) object.|
 |[Delete](../api/cloudpcdeviceimage-delete.md)|None|Delete a [cloudPcDeviceImage](../resources/cloudpcdeviceimage.md) object.|
 |[Get source images](../api/cloudpcdeviceimage-getsourceimages.md)|[cloudPcSourceDeviceImage](../resources/cloudpcsourcedeviceimage.md) collection|Get [cloudPcSourceDeviceImage](../resources/cloudpcsourcedeviceimage.md) objects.|
-|[Reupload](../api/cloudpcdeviceimage-reupload.md)|None|Reupload a [cloudPcDeviceImage](../resources/cloudpcdeviceimage.md) object that failed to upload.|
+|[Retry upload](../api/cloudpcdeviceimage-retryupload.md)|None|Retry the upload of a [cloudPcDeviceImage](../resources/cloudpcdeviceimage.md) object that previously failed.|
+|[Reupload (deprecated)](../api/cloudpcdeviceimage-reupload.md)|None|Reupload a [cloudPcDeviceImage](../resources/cloudpcdeviceimage.md) object that failed to upload. This API is deprecated and will stop returning data on June 25, 2026. Going forward, use the [cloudPcDeviceImage: retryUpload](../api/cloudpcdeviceimage-retryupload.md) API instead.|
 
 ## Properties
 
diff --git a/api-reference/beta/toc/device-and-app-management/toc.yml b/api-reference/beta/toc/device-and-app-management/toc.yml
@@ -282,7 +282,9 @@ items:
       href: ../../api/cloudpcdeviceimage-delete.md
     - name: Get source images
       href: ../../api/cloudpcdeviceimage-getsourceimages.md
-    - name: Reupload
+    - name: Retry upload
+      href: ../../api/cloudpcdeviceimage-retryupload.md
+    - name: Reupload (deprecated)
       href: ../../api/cloudpcdeviceimage-reupload.md
   - name: Cloud PC external partner setting (deprecated)
     items:
diff --git a/changelog/Microsoft.CloudManagedDesktop.json b/changelog/Microsoft.CloudManagedDesktop.json
@@ -132,6 +132,32 @@
       "WorkloadArea": "Device and app management",
       "SubArea": "Cloud PC"
     },
+    {
+      "ChangeList": [
+        {
+          "Id": "f2bf3e59-6634-4ed4-8b0d-5dcd3f9a9fe9",
+          "ApiChange": "Method",
+          "ChangedApiName": "retryUpload",
+          "ChangeType": "Addition",
+          "Description": "Added the [retryUpload](https://learn.microsoft.com/en-us/graph/api/cloudpcdeviceimage-retryupload?view=graph-rest-beta) method to the [cloudPcDeviceImage](https://learn.microsoft.com/en-us/graph/api/resources/cloudpcdeviceimage?view=graph-rest-beta) resource.",
+          "Target": "cloudPcDeviceImage"
+        },
+        {
+          "Id": "f2bf3e59-6634-4ed4-8b0d-5dcd3f9a9fe9",
+          "ApiChange": "Method",
+          "ChangedApiName": "reupload",
+          "ChangeType": "Deprecation",
+          "Description": "Deprecated the [reupload](https://learn.microsoft.com/en-us/graph/api/cloudpcdeviceimage-reupload?view=graph-rest-beta) method on the [cloudPcDeviceImage](https://learn.microsoft.com/en-us/graph/api/resources/cloudpcdeviceimage?view=graph-rest-beta) resource. Going forward, use the [retryUpload](https://learn.microsoft.com/en-us/graph/api/cloudpcdeviceimage-retryupload?view=graph-rest-beta) API instead.",
+          "Target": "cloudPcDeviceImage"
+        }
+      ],
+      "Id": "f2bf3e59-6634-4ed4-8b0d-5dcd3f9a9fe9",
+      "Cloud": "Prod",
+      "Version": "beta",
+      "CreatedDateTime": "2026-02-25T00:00:00Z",
+      "WorkloadArea": "Devices and app management",
+      "SubArea": "Cloud PC"
+    },
     {
       "ChangeList": [
         {
diff --git a/concepts/whats-new-overview.md b/concepts/whats-new-overview.md
@@ -121,6 +121,11 @@ Added the [ownerlessGroupPolicy](/graph/api/resources/ownerlessgrouppolicy?view=
 
 Introduced the Entra Backup and Recovery APIs to enable IT administrators to back up and restore Microsoft Entra ID tenant data. You can view snapshots and start preview jobs for analysis before running the recovery jobs. You can also monitor the status of recovery processes including successes and failures. For more information, see [Overview of Microsoft Entra Backup and Recovery APIs](/graph/api/resources/entrarecoveryservices-backup-recovery-overview).
 
+### Device and app management | Cloud PC
+
+- [Retry the upload](/graph/api/cloudpcdeviceimage-retryupload?view=graph-rest-beta&preserve-view=true) of a [cloudPcDeviceImage](/graph/api/resources/cloudpcdeviceimage?view=graph-rest-beta&preserve-view=true) object that previously failed.
+- Deprecated the [reupload](/graph/api/cloudpcdeviceimage-reupload?view=graph-rest-beta&preserve-view=true) method in favor of [retryUpload](/graph/api/cloudpcdeviceimage-retryupload?view=graph-rest-beta&preserve-view=true).
+
 ### Identity and access | Governance
 
 - Added **privilegeLevel** as a property on [accessPackageCatalog](/graph/api/resources/accesspackagecatalog?view=graph-rest-beta&preserve-view=true). This value represents the privilege level of the access package catalogs.
