organization resource type

Important: APIs under the / beta version in Microsoft Graph are in preview and are subject to change. Use of these APIs in production applications is not supported.

Note: Using the Microsoft Graph APIs to configure Intune controls and policies still requires that the Intune service is correctly licensed by the customer.

The organization resource represents an instance of global settings and resources which operate and are provisioned at the tenant-level.


Method Return Type Description
List organizations organization collection List properties and relationships of the organization objects.
Get organization organization Read properties and relationships of the organization object.
Update organization organization Update the properties of a organization object.
setMobileDeviceManagementAuthority action Int32 Set mobile device management authority


Property Type Description
id String The GUID for the object.
mobileDeviceManagementAuthority mdmAuthority Mobile device management authority. Possible values are: unknown, intune, sccm, office365.
certificateConnectorSetting certificateConnectorSetting Certificate connector setting.



JSON Representation

Here is a JSON representation of the resource.

  "@odata.type": "#microsoft.graph.organization",
  "id": "String (identifier)",
  "mobileDeviceManagementAuthority": "String",
  "certificateConnectorSetting": {
    "@odata.type": "microsoft.graph.certificateConnectorSetting",
    "status": 1024,
    "certExpiryTime": "String (timestamp)",
    "enrollmentError": "String",
    "lastConnectorConnectionTime": "String (timestamp)",
    "connectorVersion": "String",
    "lastUploadVersion": 1024