Changelog for Microsoft Graph

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

April 2017

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 appReportingOverviewStatus entity
Change Beta Added the sharedIPadMaximumUserCount and enableSharedIPad properties to the depEnrollmentProfile entity
Change Beta Added the shareTokenWithSchoolDataSyncService and lastSyncErrorCode properties to the depOnboardingSetting entity
Change Beta Added the pendingCount, successCount, errorCount, failedCount, lastUpdateDateTime and configurationVersion properties to the deviceComplianceDeviceOverview entity
Change Beta Removed the numberOfPendingDevices, numberOfSucceededDevices, numberOfErrorDevices, numberOfFailedDevices, lastUpdateTime and policyRevision properties from the deviceComplianceDeviceOverview entity
Change Beta Added the pendingCount, successCount, errorCount, failedCount, lastUpdateDateTime and configurationVersion properties to the deviceComplianceUserOverview entity
Change Beta Removed the numberOfPendingUsers, numberOfSucceededUsers, numberOfErrorUsers, numberOfFailedUsers, lastUpdateTime and policyRevision properties from the deviceComplianceUserOverview entity
Change Beta Added the pendingCount, successCount, errorCount, failedCount, lastUpdateDateTime and configurationVersion properties to the deviceConfigurationDeviceOverview entity
Change Beta Removed the numberOfPendingDevices, numberOfSucceededDevices, numberOfErrorDevices, numberOfFailedDevices, lastUpdateTime and policyRevision properties from the deviceConfigurationDeviceOverview entity
Change Beta Added the pendingCount, successCount, errorCount, failedCount, lastUpdateDateTime and configurationVersion properties to the deviceConfigurationUserOverview entity
Change Beta Removed the numberOfPendingUsers, numberOfSucceededUsers, numberOfErrorUsers, numberOfFailedUsers, lastUpdateTime and policyRevision properties from the deviceConfigurationUserOverview entity
Change Beta Added the subscriptionState property to the deviceManagement entity
Change Beta Added the managedEmailProfileRequired property to the iosCompliancePolicy entity
Change Beta Added the appsSingleAppModeList property to the iosGeneralDeviceConfiguration entity
Change Beta Removed the appsSingleAppModeBundleIds property from the iosGeneralDeviceConfiguration entity
Change Beta Added the expirationDateTime property to the iosLobAppProvisioningConfiguration entity
Change Beta Removed the expiration property from the iosLobAppProvisioningConfiguration entity
Change Beta Added the passwordMinimumCharacterSetCount, osMinimumVersion, osMaximumVersion, deviceThreatProtectionEnabled, deviceThreatProtectionRequiredSecurityLevel and storageRequireEncryption properties to the macOSCompliancePolicy entity
Change Beta Removed the manifest property from the managedAndroidLobApp entity
Change Beta Added the isSupervised, exchangeLastSuccessfulSyncDateTime, exchangeAccessState and exchangeAccessStateReason properties to the managedDevice entity
Change Beta Added the deviceExchangeAccessStateSummary property to the managedDeviceOverview entity
Change Beta Removed the manifest property from the managedIOSLobApp entity
Change Beta Removed the installSummary property from the mobileApp entity
Change Beta Added the uploadState property to the mobileAppContentFile entity
Change Beta Changed the following properties on the mobileAppContentFile entity:
azureStorageUriExpirationDateTime from required to optional
Change Beta Added the initiatedByUserPrincipalName, deviceOwnerUserPrincipalName, deviceIMEI and actionState properties to the remoteActionAudit entity
Change Beta Added the oneDriveDisableFileSync, safeSearchFilter, edgeSearchEngine, settingsBlockSettingsApp, settingsBlockSystemPage, settingsBlockDevicesPage, settingsBlockNetworkInternetPage, settingsBlockPersonalizationPage, settingsBlockAccountsPage, settingsBlockTimeLanguagePage, settingsBlockEaseOfAccessPage, settingsBlockPrivacyPage, settingsBlockUpdateSecurityPage, experienceBlockWindowsSpotlight, experienceBlockWindowsTips, experienceBlockConsumerSpecificFeatures, startMenuLayoutXml, startMenuMode, logonBlockFastUserSwitching and startBlockUnpinningAppsFromTaskbar properties to the windows10GeneralConfiguration entity
Change Beta Added the allowPrinting, allowScreenCapture and allowTextSuggestion properties to the windows10SecureAssessmentConfiguration entity
Change Beta Removed the blockPrinting, blockScreenCapture and blockTextSuggestion properties from the windows10SecureAssessmentConfiguration entity
Change Beta Added the identityName property to the windowsAppX entity
Change Beta Changed the type of the following properties on the windowsAppX entity:
applicableArchitectures from windowsArchitecture to String
Change Beta Added the identityName property to the windowsPhone81AppX entity
Change Beta Changed the type of the following properties on the windowsPhone81AppX entity:
applicableArchitectures from windowsArchitecture to String
Change Beta Added the identityName, identityPublisherHash and identityResourceIdentifier properties to the windowsUniversalAppX entity
Change Beta Changed the type of the following properties on the windowsUniversalAppX entity:
applicableArchitectures from windowsArchitecture to String
applicableDeviceTypes from windowsDeviceType to String
Change Beta Added the restartMode property to the windowsUpdateForBusinessConfiguration entity
Change Beta Added the managedDeviceCertificateStates navigation property to the androidForWorkScepCertificateProfile entity
Change Beta Added the managedDeviceCertificateStates navigation property to the androidScepCertificateProfile entity
Change Beta Added the enterpriseCodeSigningCertificates, symantecCodeSigningCertificate, sideLoadingKeys, managedAppPolicies, iosManagedAppProtections, androidManagedAppProtections, defaultManagedAppProtections, targetedManagedAppConfigurations, mdmWindowsInformationProtectionPolicies, windowsInformationProtectionPolicies, managedAppRegistrations and managedAppStatuses navigation properties to the deviceAppManagement entity
Change Beta Removed the appReportingOverview, enterpriseCerts and symantecCert navigation properties from the deviceAppManagement entity
Change Beta Added the deviceSettingStateSummaries navigation property to the deviceCompliancePolicy entity
Change Beta Added the deviceSettingStateSummaries navigation property to the deviceConfiguration entity
Change Beta Added the termsAndConditions, androidForWorkSettings, androidForWorkAppConfigurationSchemas, applePushNotificationCertificate, softwareUpdateStatusSummary, deviceCompliancePolicyDeviceStateSummary, complianceSettingStateSummaries, deviceConfigurationDeviceStateSummaries and mobileThreatDefenseConnectors navigation properties to the deviceManagement entity
Change Beta Removed the teacherRootCertificates, teacherIdentityCertificate, studentRootCertificates and studentIdentityCertificate navigation properties from the iosEducationDeviceConfiguration entity
Change Beta Changed the type of the following properties on the iosLobAppProvisioningConfiguration entity:
deviceStatuses from managedDeviceMobileAppProvisioningConfigurationDeviceStatus collection to managedDeviceMobileAppConfigurationDeviceStatus collection
groupAssignments from appProvisioningConfigGroupAssignment collection to mobileAppProvisioningConfigGroupAssignment collection
Change Beta Added the managedDeviceCertificateStates navigation property to the iosScepCertificateProfile entity
Change Beta Added the managedDeviceCertificateStates navigation property to the macOSScepCertificateProfile entity
Change Beta Added the deviceConfigurationStates and deviceCompliancePolicyStates navigation properties to the managedDevice entity
Change Beta Added the deviceStatusSummary and userStatusSummary navigation properties to the managedDeviceMobileAppConfiguration entity
Change Beta Added the installSummary navigation property to the mobileApp entity
Change Beta Removed the sideLoadingKeys navigation property from the organization entity
Change Beta Added the managedDeviceCertificateStates navigation property to the windows81SCEPCertificateProfile entity
Change Beta Added the managedDeviceCertificateStates navigation property to the windowsPhone81SCEPCertificateProfile entity
Change Beta Removed the applicationId, appName, platformId, userFailures and deviceFailures properties from the appInstallationFailure complex type
Change Beta Added the displayName property to the iosHomeScreenFolderPage complex type
Change Beta Added the displayName property to the iosHomeScreenPage complex type
Change Beta Added the subjectName, description, expirationDateTime and certificate properties to the windowsInformationProtectionDataRecoveryCertificate complex type
Change Beta Removed the dataRecoveryCertificate and certificateFileName properties from the windowsInformationProtectionDataRecoveryCertificate complex type
Change Beta Added the displayName property to the windowsPackageInformation complex type
Change Beta Changed the type of the following properties on the windowsPackageInformation complex type:
applicableArchitecture from windowsArchitecture to String
Change Beta Changed the following properties on the windowsPackageInformation complex type:
applicableArchitecture from optional to required

Add contracts to Microsoft Graph

Change type Version Description
Addition Beta New resource:
contract

Add domain operations to Microsoft Graph

Change type Version Description
Addition Beta Added functions on domains.
New entities:
domain
domainDnsRecord
domainDnsCnameRecord
domainDnsMxRecord
domainDnsSrvRecord
domainDnsTxtRecord
domainDnsUnavailableRecord
New actions:
forceDelete
verify

Add custom data to Microsoft Graph using schema extensions

Change type Version Description
Addition Beta Extend Microsoft Graph with application data by using schema extensions. This is supported on the following resources:
administrative unit
calendar event
device
group
message
organization
personal contact
post
user
See the following example:
Add custom data to groups using Schema Extensions (preview)
Addition Beta Provided an alternative way to create a schema extension definition without requiring a verified .com vanity domain. See schema extensions for details.

Add custom data to Microsoft Graph using open extensions

Change type Version Description
Change v1.0 and beta Renamed former "Office 365 data extensions" as "open extensions".
Addition Beta Added resources that support open extensions:
administrative unit
device
group
organization
user
See the following example:
Add custom data to users using open extensions (preview)

Directory APIs

Change type Version Description
Addition Beta Added support for restoring and permanently deleting groups.
New entity: directory with deleteditems navigation property.
Addition Beta New entity:
Endpoint
Change Beta New endpoints navigation property on groups
Addition Beta New entity:
licenseDetails
Change Beta New licensedetails navigation property on users

Reports APIs

Change type Version Description
Addition Beta Introduced the new preview API for Office 365 Reports. You can use it to get usage reports of how people in your business are using Office 365 services. For example, you can identify who is using a service a lot and reaching quotas, or who may not need an Office 365 license at all. For more details, see report.

Directory APIs

Change type Version Description
Addition Beta New entity:
contract

February 2017

Intune APIs

Change type Version Description
Addition Beta Added new entities:
androidForWorkCertificateProfileBase
androidForWorkEasEmailProfileBase
androidForWorkEnterpriseWiFiConfiguration
androidForWorkGmailEasConfiguration
androidForWorkNineWorkEasConfiguration
androidForWorkPkcsCertificateProfile
androidForWorkScepCertificateProfile
androidForWorkTrustedRootCertificate
androidForWorkWiFiConfiguration
appleDeviceFeaturesConfigurationBase
appProvisioningConfigGroupAssignment
deviceComplianceUserOverview
deviceConfigurationUserOverview
enterpriseCertificate
iosEducationDeviceConfiguration
macOSDeviceFeaturesConfiguration
managedAndroidLobApp
managedDeviceMobileAppProvisioningConfigurationDeviceStatus
managedIOSLobApp
managedMobileLobApp
symantecCertificate
windowsAppX
windowsCertificateProfileBase
windowsPhone81AppX
windowsPhone81AppXBundle
windowsPhoneXAP
windowsUniversalAppX
Addition Beta Added new complex types:
airPrintDestination
windowsArchitecture
windowsDeviceType
windowsMinimumOperatingSystem
windowsPackageInformation
Addition Beta Added the assign action on the iosLobAppProvisioningConfiguration entity
Addition Beta Added the scheduleActionsForRules action on the deviceCompliancePolicy entity
Addition Beta Added the updateTargetedSecurityGroups action on the targetedManagedAppConfiguration entity
Addition Beta Added the getScopesForUser function on the resourceOperation entity
Change Beta Removed the manifest property from the androidLobApp entity
Change Beta Added the assetTagTemplate, lockScreenFootnote, homeScreenDockIcons and homeScreenPages properties to the iosDeviceFeaturesConfiguration entity
Change Beta Removed the deviceSharingAssetTagInformation, deviceSharingLockScreenFootnote, homeScreenLayoutDockIcons and homeScreenLayoutPages properties from the iosDeviceFeaturesConfiguration entity
Change Beta Added the appsSingleAppModeBundleIds property to the iosGeneralDeviceConfiguration entity
Change Beta Removed the manifest property from the iosLobApp entity
Change Beta Added the createdDateTime, description, lastModifiedDateTime, displayName and version properties to the iosLobAppProvisioningConfiguration entity
Change Beta Added the createdDateTime and lastModifiedDateTime properties to the managedAppPolicy entity
Change Beta Removed the deviceRegistrationState property from the managedDevice entity
Change Beta Added the manifest property to the mobileAppContentFile entity
Change Beta Added the osDescription and userName properties to the mobileAppInstallStatus entity
Change Beta Removed the deviceType property from the mobileAppInstallStatus entity
Change Beta Changed the type of the following properties on the mobileAppInstallStatus entity:
mobileAppInstallStatusValue from Int32 to String
Change Beta Added the targetedSecurityGroupIds and targetedSecurityGroupsCount properties to the targetedManagedAppConfiguration entity
Change Beta Removed the numberOfTargetedSecurityGroups property from the targetedManagedAppConfiguration entity
Change Beta Added the id property to the user entity
Change Beta Removed the renewalThresholdPercentage, keyStorageProvider, subjectNameFormat, subjectAlternativeNameType, certificateValidityPeriodValue and certificateValidityPeriodScale properties from the windows10CertificateProfileBase entity
Change Beta Removed the renewalThresholdPercentage, keyStorageProvider, subjectNameFormat, subjectAlternativeNameType, certificateValidityPeriodValue and certificateValidityPeriodScale properties from the windows81CertificateProfileBase entity
Change Beta Removed the applyToWindows10Mobile property from the windowsPhone81GeneralConfiguration entity
Change Beta Added the enterpriseCerts, iosLobAppProvisioningConfigurations and symantecCert navigation properties to the deviceAppManagement entity
Change Beta Added the userStatusOverview navigation property to the deviceCompliancePolicy entity
Change Beta Added the userStatusOverview navigation property to the deviceConfiguration entity
Change Beta Added the groupAssignments, deviceStatuses and userStatuses navigation properties to the iosLobAppProvisioningConfiguration entity
Change Beta Changed the type of the following properties on the windows10VpnConfiguration entity:
identityCertificate from windows10CertificateProfileBase to windowsCertificateProfileBase
Change Beta Added the deviceComplianceCheckinThresholdDays and isScheduledActionEnabled properties to the deviceManagementSettings complex type
Change Beta Removed the windowsCommercialId and windowsCommercialIdLastModifiedTime properties from the deviceManagementSettings complex type
Change Beta Added the bundleID, appName, publisher, enabled and showOnLockScreen properties to the iosNotificationSettings complex type
Change Beta Removed the bundleIdentifier, notificationsEnabled and showInLockScreen properties from the iosNotificationSettings complex type

January 2017

Outlook calendar

Change type Version Description
Addition v1.0 New action findMeetingTimes for the user resource.
Addition v1.0 New complex type attendeeBase which consists of a type property for the attendee type.
Addition v1.0 New complex types:
attendeeAvailability
locationConstraint
locationConstraintItem
meetingTimeSuggestion
meetingTimeSuggestionsResult
timeConstraint
timeSlot
Change v1.0 The attendee complex type is now derived from attendeeBase, which in turn is derived from recipient. Including the inherited properties, it consists of the same status, type and emailAddress properties as before.
Addition Beta hexColor added to the calendar resource.

Intune APIs

Change type Version Description
Addition Beta Added new entities:
appReportingOverviewStatus
deviceComplianceDeviceOverview
deviceConfigurationDeviceOverview
deviceManagementExchangeOnpremisesPolicy
iosDeviceFeaturesConfiguration
iosEducationDeviceConfiguration
iosLobAppProvisioningConfiguration
onpremisesConditionalAccessSettings
sharedPCConfiguration
windows10EnterpriseModernAppManagementConfiguration
windows10SecureAssessmentConfiguration
windows10WindowsInformationProtectionConfiguration
Addition Beta Added new complex types:
appInstallationFailure
enterpriseCloudResource
iosHomeScreenApp
iosHomeScreenFolder
iosHomeScreenFolderPage
iosHomeScreenItem
iosHomeScreenPage
iosNotificationSettings
iPv6Range
sharedPCAccountManagerPolicy
windowsInformationProtectionAppRule
windowsInformationProtectionAppRuleAppLockerPolicyFileTemplate
windowsInformationProtectionAppRuleDesktopTemplate
windowsInformationProtectionAppRuleStoreAppTemplate
windowsInformationProtectionAppRuleTemplate
windowsInformationProtectionCorporateNetworkLocation
windowsInformationProtectionDataRecoveryCertificate
windowsInformationProtectionProtectedLocation
windowsInformationProtectionProtectedLocationEnterpriseCloudResources
windowsInformationProtectionProtectedLocationEnterpriseInternalProxyServers
windowsInformationProtectionProtectedLocationEnterpriseIPv4Ranges
windowsInformationProtectionProtectedLocationEnterpriseIPv6Ranges
windowsInformationProtectionProtectedLocationEnterpriseNetworkDomainNames
windowsInformationProtectionProtectedLocationEnterpriseProxyServers
windowsInformationProtectionProtectedLocationNeutralResources
Deletion Beta Removed the following complex types and replaced with microsoft.graph.Json:
managedAppDeploymentSummary
managedAppSummary
Change Beta Replaced the property type appConfigComplianceStatus with complianceStatus on the following entities:
managedDeviceMobileAppConfigurationDeviceStatus
managedDeviceMobileAppConfigurationUserStatus
Change Beta For resource managedAppStatusRaw, changed type of property content from managedAppSummary to Json.
Change Beta Removed the getUsersWithFlaggedAppRegistration function from the managedAppRegistration collection.
Change Beta Changed the vppToken navigation property of the iosVppApp entity to no longer be a contained collection.
Change Beta Added the deviceStatusOverview property to the deviceConfiguration and deviceCompliancePolicy entities.
Change Beta Added the appReportingOverview property to the deviceAppManagement singleton.
Change Beta Added the deviceDisplayName and userPrincipalName properties to the deviceConfigurationDeviceStatus, deviceComplianceDeviceStatus and managedDeviceMobileAppConfigurationDeviceStatus entities.
Change Beta Add the ruleName property to the deviceComplianceScheduledActionForRule entity.
Change Beta Added the devicesCount, userDisplayName and userPrincipalName properties to the deviceConfigurationUserStatus, deviceComplianceUserStatus, and managedDeviceMobileAppConfigurationUserStatus entities.
Change Beta Added the notificationMessageTemplates collection to the deviceManagement singleton.
Change Beta Added the isDefault, lastModifiedDateTime, locale, messageTemplate and subject properties to thelocalizedNotificationMessage entity.
Change Beta Added the azureActiveDirectoryDeviceId, deviceCategory, deviceRegistrationState and managementAgent properties to the managedDevice entity.
Change Beta Added the lastModifiedDateTime property to the mobileAppCategory entity.
Change Beta Added the brandingOptions, defaultLocale, displayName, fromEmailAddress, lastModifiedDateTime, localizedNotificationMessages properties to the notificationMessageTemplate entity.
Change Beta Added the appsAllowTrustedAppsSideloading, appsBlockWindowsStoreOriginatedApps, developerUnlockSetting, edgeBlockAccessToAboutFlags, edgeBlockDeveloperTools, edgeBlockExtensions, edgeBlockInPrivateBrowsing, edgeFirstRunUrl, edgeHomepageUrls, gameDvrBlocked, settingsBlockAddProvisioningPackage, settingsBlockChangeLanguage, settingsBlockChangePowerSleep, settingsBlockChangeRegion, settingsBlockChangeSystemTime, settingsBlockEditDeviceName, settingsBlockRemoveProvisioningPackage, sharedUserAppDataAllowed, smartScreenBlockPromptOverride, smartScreenBlockPromptOverrideForFiles, storageRestrictAppDataToSystemVolume, storageRestrictAppInstallToSystemVolume, webRtcBlockLocalhostIpAddress, windowsStoreBlockAutoUpdate and windowsStoreEnablePrivateStoreOnly properties to the windows10GeneralConfiguration entity.

December 2016

Delta query

Change type Version Description
Addition Beta A new delta function add to the following entities to perform delta query:
contact
contactFolder
event
group
mailFolder
message
user
See the following for examples:
Get incremental changes to groups (preview)
Get incremental changes to messages in a folder (preview)
Get incremental changes to users (preview)

Excel APIs

Change type Version Description
Addition v1.0 Added workbookPivotTable resource, refresh and refreshAll action on pivotTables, workbookRangeView resource, visibleView action on the filtered range to return workbookRangeView to the user, get rows collection and range resource off of visibleView, columnsAfter, columnsBefore, resizedRange, rowsAbove, and rowsBelow functions off of range resource, and new table properties.

Intune APIs

Change type Version Description
Addition Beta Added resources and method APIs for Microsoft Intune. This is a large set of resources and methods to support the public preview of Intune on Azure Portal. For information about the Intune service, see the Intune documentation. For information about the Intune resources and APIs, see Working with Intune in Microsoft Graph.

October 2016

Authorization provider

Change type Version Description
Addition v1.0 and beta The v2.0 auth endpoint now supports the client_credentials OAuth grant, which can be used for daemon & long running processes in business scenarios.
Addition v1.0 and beta The v2.0 auth endpoint now supports permission scopes that require administrator's consent, via the admin consent endpoint.
Addition v1.0 and beta The v2.0 auth endpoint now supports administrative consent for all users in a tenant, via the admin consent endpoint.

Invitation APIs

Change type Version Description
Addition Beta Added invitedUserType property to the invitation entity type, that defines the type of user (Guest or Member) that is invited.
Deletion Beta We will be removing the invitedToGroups property from the invitation entity-type on 11/11/2016. This means that you will no longer be able to add an invited user to a group using this API. Instead, use the add member API to add a user to a group.

September 2016

Azure AD application proxy

Change type Version Description
Addition Beta Azure AD Application Proxy APIs are now available in the Microsoft Graph beta endpoint. These APIs allow for secure publishing of on-premises applications to users outside the corporate network using Azure AD as the common control plane for access. You can use the published APIs to write applications that can retrieve and update various aspects of application proxy, such as connectors, connectorGroups and the onPremisesPublishing settings of an application.

Drive

Change type Version Description
Addition Beta Added shared collection to allow accessing shared driveItems by shareId or sharing URL.
Addition Beta Added search function to a drive, which allows searching for more items than just those in the drive's root folder.

DriveItem

Change type Version Description
Addition Beta Added support for createUploadSession, which allows uploading files larger than 4 MB to OneDrive, OneDrive for Business, and SharePoint document libraries.
Addition Beta Added sharepointIds property to driveItem that returns traditional SharePoint API identifiers for driveItems stored in SharePoint.
Addition Beta Added additional properties on remoteItem.
Addition Beta Added the quickXorHash value for files in OneDrive for Business.
Addition Beta Added scope to the createSharingLink to allow creating company sharable links or anonymous sharing links.

Extended properties

Change type Version Description
Addition v1.0 Extended properties are now supported by the following resources: message, mailFolder, event, calendar, contact, contactFolder, group event, group calendar, group post.

Groups

Added support for dynamic group membership through the public preview API, including the additions listed in the following table.

Change type Version Description
Addition Beta Added membershipRule property contains rules that controls the memberships for this group, if the group is a dynamic group.
Addition Beta Added membershipRuleProcessingState property to control whether dynamic membership processing is on or paused for this group.
Addition Beta Set the groupTypes property to contain "DynamicMembership" to light up the dynamic groups capability for this group.
Addition Beta Added preferredLanguage property to indicate the preferred language for an Office 365 group.
Addition Beta Added theme property to specify an Office 365 group's color theme.

Hybrid deployment support

Change type Version Description
Addition v1.0 Apps can use v1.0 Outlook Mail, Calendar, and Contacts APIs to access on-premises mailboxes in a hybrid deployment with Exchange 2016 Cumulative Update 3 (CU3). Find more details about REST API support in specific hybrid deployments. Note: If you're using these sets of API in v1.0, you can now find your apps, including production apps, working for on-premises mailboxes that meet the specific hybrid deployment requirements. This capability is only in preview.

IdentityRiskEvents

Change type Version Description
Change Beta As part of the schema change where the type of two location properties is being replaced by a new complex type in the identityRiskEvents endpoint, the following properties are changed/added in the identityRiskEvents endpoint:
location changed from Edm.String to ComplexType signInLocation.
previousLocation changed from Edm.String to ComplexType signInLocation.
signInLocation new ComplexType that contains city, state, countryOrRegion and geoCoordinates properties.
geoCoordinates new ComplexType that contains latitude and longitude properties.

Invitation manager

Change type Version Description
Addition Beta Invitation manager APIs are now available in the Microsoft Graph beta endpoint. You can use invitation manager APIs to create an invite, in order to add an external user to the organization. As part of the invitation, you can also choose to add the invited user to an Office 365 group. For more details, see invitation manager.

OneDrive

Change type Version Description
Addition v1.0 Added CreateUploadSession method on driveItem, which allows large file and resumable uploads.
Addition v1.0 Added properties for tracking SharePoint IDs on items from SharePoint (sharepointIds) and a property to identify root folders (root).
Addition v1.0 Added Shares root collection, which can be used with shareIds or sharing links to access shared items in OneDrive and SharePoint. Returns a new type, sharedDriveItem.
Addition v1.0 Added Invite method on driveItem, which allows adding permissions to items.
Addition v1.0 Added Search method on drive, which allows searching across items in the drive and shared items.
Addition v1.0 Added processingMetadata property on file complex type quickXorHash property on hashes complex type.
Addition v1.0 Added quickXorHash property on hashes complex type.

Outlook calendar

Change type Version Description
Addition v1.0 Added the onlineMeetingUrl property to the event resource.
Addition Beta Added forward action to the event resource.
Addition Beta Added the following properties to the calendar resource to support calendar sharing: canEdit, canShare, canViewPrivateItems, isShared, isShareWithMe, and owner.

Outlook mail

Change type Version Description
Addition v1.0 Added the mailboxSettings complex type, which includes the automaticRepliesSetting, timeZone, and language properties.
Addition v1.0 Added the mailboxSettings property to the user resource.
Addition Beta Added support for creating, listing, getting, and deleting one or more instances of