Working with Windows 365 Cloud PCs using the Microsoft Graph API
Important
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.
Important
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
- 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.