Changelog for Microsoft Graph

This changelog covers what's changed in Microsoft Graph, including the v1.0 and beta endpoint Microsoft Graph APIs.

May 2017

SharePoint Sites API

Change type Version Description
Addition v1.0 Releasing the Sites API in v1.0 (previously only in beta).
Added the site and siteCollection resource types.

SharePoint Lists API

Change type Version Description
Change beta Removed the sharepoint navigation properties. Sites are now accessed directly through the sites navigation property.
Removed the fieldDefinition resource. It has been replaced by columnDefinition.
Removed the siteCollectionId and siteId properties from site. Use sharepointIds instead.
Removed the listItemId property from listItem. Use sharepointIds instead.
Renamed the columnSet property on listItem to fields.
Changed site resources to use the SharePoint hostname as part of their ID.
Addition beta Added the booleanColumn, calculatedColumn, choiceColumn, dateTimeColumn, lookupColumn, numberColumn, personOrGroupColumn, and textColumn resource types.
Added the displayName property to site.
Added the columns navigation property to site.
Added the list and listItem navigation properties to sharedDriveItem.
Added the sharepointIds property to list and listItem, and site.
Added the columnDefinition resource type.

Drive APIs

Change type Version Description
Addition v1.0 Added the baseItem resource type, consisting of basic properties from driveItem.
Addition v1.0 and Beta Added the sourceItemId property to thumbnail.
Added the siteUrl property to sharepointIds.
Added the sharedBy and sharedDateTime properties to shared.
Added the shared property to remoteItem.
Added the sharepointIds property to drive and itemReference.
Added lastAccessedDateTime to fileSystemInfo.
Added the driveItem and site navigation properties to sharedDriveItem.
Added the parentReference property to baseItem.
Change v1.0 and Beta Changed driveItem and sharedDriveItem to inherit from baseItem.
Marked identity as an Open Type.
Change Beta Added the configuratorUrl and webHtml properties to sharingLink.
Added the folderView resource type and the view property to the folder resource type.
Added the listItem navigation property to driveItem.
Added the list navigation property to drive.

Group

Change type Version Description
Addition v1.0 and beta Added the drives and sites navigation properties to group.

April 2017

Administrative units property changes

Change type Version Description
Change Beta Adminstrative unit APIs will be updated in preview (beta). The first set of changes will be applied on May 3, 2017. The changes include the following property renaming:
- roleMemberInfo complex type to identity complex type for the scopedRoleMembership entity
- scopedAdministratorOf navigation property to scopedRoleMemberOf for the user entity
- scopedAdministrators navigation property to scopedRoleMembers for the administrativeUnit entity
- scopedAdministrators navigation property to scopedMembers for the directoryRole entity

Application and servicePrincipal API changes

Change type Version Description
Change Beta The application and servicePrincipal APIs will be updated in preview (beta). The first set of changes will be applied on May 8, 2017. The changes include property renaming and restructuring. Some properties (such as appRoles and addIns) will not be available until the changes are completed. The changes will be released in preview (beta) prior to releasing to v1.0.

Added preview support for Cloud Solution Provider developers

Change type Version Description
Addition Beta Added new preview capability to allow Cloud Solution Provider pre-consented applications to call Microsoft Graph, described in a new authorization topic.

Added onPremises properties to user entity

Change type Version Description
Addition Beta Added new onPremises properties onPremisesDomainName, OnPremisesSamAccountName, and onPremisesUserPrincipalName to the user entity.

New Planner APIs and an update to the group visibility property

Change type Version Description
Change Beta Added HiddenMembership as an additional value for the visibility property to the Group entity
Addition Beta Added new Planner API.
New resources:
plannerPlan
plannerTask
plannerPlanDetails
plannerTaskDetails
plannerBucket
plannerAssignedToTaskBoardTaskFormat
plannerBucketTaskBoardTaskFormat
plannerProgressTaskBoardTaskFormat

Intune APIs

Change type Version Description
Addition Beta Added new entities:
androidForWorkCompliancePolicy
deviceComplianceSettingState
deviceInstallState
deviceManagementScript
deviceManagementScriptGroupAssignment
deviceManagementScriptState
eBookGroupAssignment
iosVppEBook
managedEBook
userInstallStateSummary
windowsManagementApp
windowsManagementAppHealthState
Addition Beta Added new complex types:
dailySchedule
hourlySchedule
iosBookmark
iosWebContentFilterAutoFilter
iosWebContentFilterBase
iosWebContentFilterSpecificWebsitesAccess
runSchedule
sharedAppleDeviceUser
windows10NetworkProxyServer
Addition Beta Added the requestRemoteAssistance action on managedDevice
Addition Beta Added the cleanWindowsDevice action on managedDevice
Addition Beta Added the logoutSharedAppleDeviceActiveUser action on managedDevice
Addition Beta Added the deleteUserFromSharedAppleDevice action on managedDevice
Addition Beta Added the assign action on deviceManagementScript
Addition Beta Added the syncLicenses action on appleVolumePurchaseProgramToken
Addition Beta Added the getTopMobileApps function on mobileApp collection
Addition Beta Added the downloadApplePushNotificationCertificateSigningRequest function on applePushNotificationCertificate
Addition Beta Added the getDeviceComplianceSettingStates function on deviceManagement
Addition Beta Added the deviceConfigurationUserActivity function on reportRoot
Addition Beta Added the deviceConfigurationDeviceActivity function on reportRoot
Deletion Beta Removed the following complex types:
enterpriseCloudResource
windowsInformationProtectionAppRule
windowsInformationProtectionAppRuleAppLockerPolicyFileTemplate

windowsInformationProtectionAppRuleDesktopTemplate
windowsInformationProtectionAppRuleStoreAppTemplate
windowsInformationProtectionAppRuleTemplate
windowsInformationProtectionCorporateNetworkLocation
windowsInformationProtectionProtectedLocation
windowsInformationProtectionProtectedLocationEnterpriseCloudResources

windowsInformationProtectionProtectedLocationEnterpriseInternalProxyServers
windowsInformationProtectionProtectedLocationEnterpriseIPv4Ranges
windowsInformationProtectionProtectedLocationEnterpriseIPv6Ranges

windowsInformationProtectionProtectedLocationEnterpriseNetworkDomainNames
windowsInformationProtectionProtectedLocationEnterpriseProxyServers
windowsInformationProtectionProtectedLocationNeutralResources

Change Beta Added the deviceSharingAllowed property to the androidGeneralDeviceConfiguration entity
Change Beta Removed the deviceSharingBlocked property from the androidGeneralDeviceConfiguration entity
Change Beta Added the minimumRequiredSdkVersion property to the defaultManagedAppProtection entity
Change Beta Added the windowsManagementAppEnabled property to the deviceAppManagement entity
Change Beta Added the notificationTemplateId property to the deviceComplianceActionItem entity
Change Beta Added the excludeGroup property to the deviceConfigurationGroupAssignment entity
Change Beta Changed the following properties on the iosCustomConfiguration entity:
payloadFileName from required to optional
Change Beta Added the contentFilterSettings property to the iosDeviceFeaturesConfiguration entity
Change Beta Added the cellularBlockPersonalHotspot and passcodeBlockFingerprintModification properties to the iosGeneralDeviceConfiguration entity
Change Beta Added the minimumRequiredSdkVersion property to the iosManagedAppProtection entity
Change Beta Changed the following properties on the macOSCustomConfiguration entity:
payloadFileName from required to optional
Change Beta Added the disableAppPinIfDevicePinIsSet, minimumRequiredOsVersion, minimumWarningOsVersion, minimumRequiredAppVersion and minimumWarningAppVersion properties to the managedAppProtection entity
Change Beta Added the remoteAssistanceSessionUrl, isEncrypted, model and manufacturer properties to the managedDevice entity
Change Beta Changed the following properties on the getMobileAppCount entity:
bindingParameter from mobileApp to a collection of mobileApp
status
from a GUID to a String
Change Beta Added the vpnConfigurationId property to the mobileAppGroupAssignment entity
Change Beta Removed the fromEmailAddress property from the notificationMessageTemplate entity
Change Beta Added the excludedApps property to the officeSuiteApp entity
Change Beta Removed the excludedOfficeApps property from the officeSuiteApp entity
Change Beta Added the enabled property to the sharedPCConfiguration entity
Change Beta Added the networkProxyApplySettingsDeviceWide, networkProxyDisableAutoDetect, networkProxyAutomaticConfigurationUrl, networkProxyServer, bluetoothDeviceName, wiFiScanInterval, wirelessDisplayBlockProjectionToThisDevice, wirelessDisplayBlockUserInputFromReceiver, wirelessDisplayRequirePinForPairing, experienceBlockDeviceDiscovery, experienceBlockErrorDialogWhenNoSIM, experienceBlockTaskSwitcher, startMenuPinnedFolderDocuments, startMenuPinnedFolderDownloads, startMenuPinnedFolderFileExplorer, startMenuPinnedFolderHomeGroup, startMenuPinnedFolderMusic, startMenuPinnedFolderNetwork, startMenuPinnedFolderPersonalFolder, startMenuPinnedFolderPictures, startMenuPinnedFolderSettings, startMenuPinnedFolderVideos, startMenuAppListVisibility, startMenuHideFrequentlyUsedApps, startMenuHideRecentJumpLists, startMenuHideRecentlyAddedApps, startMenuHideRestartOptions, startMenuHideUserTile, startMenuHidePowerButton, startMenuLayoutEdgeAssetsXml, personalizationDesktopImageUrl and personalizationLockScreenImageUrl properties to the windows10GeneralConfiguration entity
Change Beta Changed the type of the following properties on the windowsMobileMSI entity:
productCode from Guid to String
Change Beta Changed the following properties on the windowsPhone81AppX entity:
phoneProductIdentifier from required to optional
phonePublisherId from required to optional
Change Beta Changed the following properties on the windowsPhone81AppXBundle entity:
appXPackageInformationList from required to optional
Change Beta Added the productKey and licenseType properties to the windowsStoreForBusinessApp entity
Change Beta Added the previewBuildSetting property to the windowsUpdateForBusinessConfiguration entity
Change Beta Added the windowsManagementApp and managedEBooks navigation properties to the deviceAppManagement entity
Change Beta Added the deviceManagementScripts, managedDeviceOverview and cloudPkiSubscriptions navigation properties to the deviceManagement entity
Change Beta Added the osMinimumVersion and osMaximumVersion properties to the deviceEnrollmentPlatformRestrictions complex type
Change Beta Added the isSharedDevice and sharedDeviceCachedUsers properties to the hardwareInformation complex type
Change Beta Changed the following properties on the omaSettingBase64 complex type:
fileName from required to optional
Change Beta Changed the following properties on the omaSettingStringXml complex type:
fileName from required to optional

March 2017

Intune APIs

Change type Version Description
Addition Beta Added new entities:
androidForWorkApp
androidForWorkAppConfigurationSchema
androidForWorkSettings
androidForWorkVpnConfiguration
applePushNotificationCertificate
complianceSettingStateSummary
deviceCompliancePolicyDeviceStateSummary
deviceCompliancePolicyState
deviceConfigurationDeviceStateSummary
deviceConfigurationState
enterpriseCodeSigningCertificate
iosEduDeviceConfiguration
managedDeviceCertificateState
managedDeviceMobileAppConfigurationDeviceSummary
managedDeviceMobileAppConfigurationUserSummary
mdmWindowsInformationProtectionPolicy
mobileAppInstallSummary
mobileAppProvisioningConfigGroupAssignment
mobileThreatDefenseConnector
officeSuiteApp
settingStateDeviceSummary
softwareUpdateStatusSummary
symantecCodeSigningCertificate
windowsDefenderAdvancedThreatProtectionConfiguration
windowsInformationProtection
windowsInformationProtectionAppLockerFile
windowsInformationProtectionPolicy
windowsMobileMSI
Addition Beta Added new complex types:
androidForWorkAppConfigurationExample
androidForWorkAppConfigurationExampleJson
androidForWorkAppConfigurationSchemaItem
deviceCompliancePolicySettingState
deviceConfigurationSettingState
deviceExchangeAccessStateSummary
edgeSearchEngine
edgeSearchEngineBase
edgeSearchEngineCustom
excludedApps
iosEduCertificateSettings
ipRange
windowsInformationProtectionApp
windowsInformationProtectionCloudResource
windowsInformationProtectionCloudResourceCollection
windowsInformationProtectionDesktopApp
windowsInformationProtectionIPRangeCollection
windowsInformationProtectionResourceCollection
windowsInformationProtectionStoreApp
Addition Beta Added the requestSignupUrl action on androidForWorkSettings
Addition Beta Added the completeSignup action on androidForWorkSettings
Addition Beta Added the syncApps action on androidForWorkSettings
Addition Beta Added the unbind action on androidForWorkSettings
Addition Beta Added the assign action on iosLobAppProvisioningConfiguration
Addition Beta Added the recoverPasscode action on managedDevice
Addition Beta Added the removeApplePushNotificationCertificate action on organization
Addition Beta Added the updateMobileAppIdentifierDeployments action on iosManagedAppProtection
Addition Beta Added the updateMobileAppIdentifierDeployments action on androidManagedAppProtection
Addition Beta Added the updateMobileAppIdentifierDeployments action on targetedManagedAppConfiguration
Addition Beta Added the updateTargetedSecurityGroups action on iosManagedAppProtection
Addition Beta Added the updateTargetedSecurityGroups action on androidManagedAppProtection
Addition Beta Added the updateTargetedSecurityGroups action on windowsInformationProtection
Addition Beta Added the updateTargetedSecurityGroups action on windowsInformationProtectionPolicy
Addition Beta Added the updateTargetedSecurityGroups action on mdmWindowsInformationProtectionPolicy
Addition Beta Added the wipeManagedAppRegistrationByDeviceTag action on user
Addition Beta Added the getTopMobileApps function on mobileApp
Addition Beta Added the verifyWindowsEnrollmentAutoDiscovery function on deviceManagement
Deletion Beta Removed the following entities:
appProvisioningConfigGroupAssignment
defaultManagedAppConfiguration
enterpriseCertificate

managedDeviceMobileAppProvisioningConfigurationDeviceStatus
symantecCertificate
windows10WindowsInformationProtectionConfiguration

Deletion Beta Removed the following complex types:
mobileAppInstallSummary
windowsArchitecture
windowsDeviceType

Change Beta Added the webBrowserBlockPopups property to the androidGeneralDeviceConfiguration entity
Change Beta Removed the webBrowserAllowPopups property from the androidGeneralDeviceConfiguration entity
Change Beta Added the appIdentifier property to the androidStoreApp entity
Change Beta Removed the applicationCount, failedApplicationCount and appInstallFailures properties from the appReport