Working with Windows 365 Cloud PCs using the Microsoft Graph API


APIs under the /beta version in Microsoft Graph are subject to change. Use of these APIs in production applications is not supported. To determine whether an API is available in v1.0, use the Version selector.

Windows 365 is a cloud-based service that automatically creates a new type of Windows virtual machine (Cloud PCs) for your end users. Each Cloud PC is assigned to an individual user as a dedicated Windows device. Windows 365 provides the productivity, security, and collaboration benefits of Microsoft 365.

The Microsoft Graph API enables programmatic access to Cloud PC information and management actions on your organization. The API performs the same operations as those available through Microsoft Endpoint Manager.


Using the Microsoft Graph API for Cloud PCs requires an active Windows 365 license for the organization. Currently, Microsoft Graph API is available for both Windows 365 Enterprise and Windows 365 Business.

Using the Microsoft Graph API for Cloud PCs

With Microsoft Graph, you can provision and manage Cloud PCs in your organization. If used in conjunction with the Intune API, you can manage Cloud PCs alongside physical endpoints as well.

Using Microsoft Graph permissions

Microsoft Graph controls access to resources via permissions. As a developer, you must specify the permissions you need to access Windows 365 resources. Typically, you specify the permissions in the Microsoft Entra admin center. For more information, see Microsoft Graph permissions reference and navigate to the Cloud PC permissions section.

Common use cases

Use cases REST resources See also
List, get, create, update, delete, or assign provisioning policies. cloudPcProvisioningPolicy Provisioning overview
Manage Cloud PCs including reprovision, end Cloud PC grace period, bulk reprovision, and resize Cloud PCs. cloudPC Cloud PCs lifecycle
List, get, create, delete, get source images, and reupload Cloud PC OS images. cloudPCDeviceImage Device images overview
List and get gallery images. cloudPcGalleryImage Gallery images overview
List, get, create, update delete, update AD domain password, and run health checks for Azure network connections. cloudPcOnPremisesConnection On-premises network connection overview
List audit events for Cloud PCs, get a specific audit event, and get audit activity types. cloudPcAuditEvent Get Cloud PC audit logs
List, get, create, update, delete or assign user settings. cloudPcUserSetting User settings overview
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, alertRule Alert monitoring API

Next steps