user resource type

Namespace: microsoft.graph

Important: Microsoft Graph APIs under the /beta version are subject to change; production use is not supported.

Note: The Microsoft Graph API for Intune requires an active Intune license for the tenant.

Represents an Azure Active Directory user object.


Method Return Type Description
List users objects. user collection List properties and relationships of the user objects.
Get user object. user Read properties and relationships of the user object.
Create user object. user Create a new user object.
Delete user. None Deletes a user.
Update user object. user Update the properties of a user object.
Device management
getLoggedOnManagedDevices function managedDevice collection
removeAllDevicesFromManagement action None Retire all devices from management for this user
Mobile application management (MAM)
getManagedAppDiagnosticStatuses function managedAppDiagnosticStatus collection Gets diagnostics validation status for a given user.
getManagedAppPolicies function managedAppPolicy collection Gets app restrictions for a given user.
wipeManagedAppRegistrationByDeviceTag action None Issues a wipe operation on an app registration with specified device tag.
wipeManagedAppRegistrationsByDeviceTag action None Issues a wipe operation on an app registration with specified device tag.
exportDeviceAndAppManagementData function deviceAndAppManagementData
getEffectiveDeviceEnrollmentConfigurations function deviceEnrollmentConfiguration collection
getManagedDevicesWithAppFailures function String collection Retrieves the list of devices with failed apps.


Property Type Description
id String Unique identifier of the user.
deviceEnrollmentLimit Int32 The limit on the maximum number of devices that the user is permitted to enroll. Allowed values are 5 or 1000.


Relationship Type Description
Device management
managedDevices managedDevice collection The managed devices associated with the user.
Mobile application management (MAM)
managedAppRegistrations managedAppRegistration collection Zero or more managed app registrations that belong to the user.
deviceEnrollmentConfigurations deviceEnrollmentConfiguration collection Get enrollment configurations targeted to the user
deviceManagementTroubleshootingEvents deviceManagementTroubleshootingEvent collection The list of troubleshooting events for this user.
mobileAppIntentAndStates mobileAppIntentAndState collection The list of troubleshooting events for this user.
mobileAppTroubleshootingEvents mobileAppTroubleshootingEvent collection The list of mobile app troubleshooting events for this user.

JSON Representation

Here is a JSON representation of the resource.

  "@odata.type": "#microsoft.graph.user",
  "id": "String (identifier)"