Working with Windows 365 Cloud PCs using the Microsoft Graph API
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.
Important
Using the Microsoft Graph API for Cloud PCs requires an active Windows 365 license for the organization. Currently, the 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.
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 end Cloud PC grace period, troubleshoot, reboot, rename, and restore a Cloud PC. | cloudPC | Cloud PCs lifecycle |
| List, get, create, delete, and get source images. | cloudPcDeviceImage | Device images overview |
| List and get gallery images. | cloudPcGalleryImage | Gallery images overview |
| List, get, create, update delete, 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 |
Next steps
- Check out the overview for Windows 365 Cloud PC on Microsoft Graph.
- Try out the Windows 365 Cloud PCs APIs by using the Microsoft Graph Explorer.