Edit

Working with Windows 365 Cloud PCs using the Microsoft Graph API

  • Article

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