Changelog for Microsoft Graph

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

For details about known issues with Microsoft Graph APIs, see Known issues.

December 2018

Directory APIs

Change type Version Description
Addition Beta Added the createdDateTime property to the organization resource.
Addition v1.0 Added method memberOf to get a devices direct membership. This method has been added for getting the list of memberships including nested memberships.

Microsoft Teams APIs

Change type Version Description
Addition beta Introduced new resource type teamsTemplate.
Addition beta Introduced new resource type teamSpecialization.
Addition beta Added the isFavoriteByDefault, mail, and webUrl properties to channel.
Addition beta Added the displayName property to team.
Addition beta Added the description property to team.
Addition beta Added the classification property to team.
Addition beta Added the specialization property to team.
Addition beta Added the visibility property to team.
Addition beta Added the template property to team.
Addition beta Added the owners collection to team.
Addition beta Introduced new enum member unknownFutureValue to teamVisibilityType.
Addition beta Introduced new enum member unknownFutureValue to giphyRatingType.
Addition beta Introduced new enum member unknownFutureValue to teamsAsyncOperationType.
Addition beta Introduced new enum member unknownFutureValue to teamsAsyncOperationStatus.
Addition beta Introduced new enum member unknownFutureValue to teamsAppDistributionMethod.
Addition beta Introduced new resource /teamsTemplates.

Privileged Identity Management APIs

Change type Version Description
Addition beta Added property registeredRoot to the governanceResource entity.
Change beta Renamed property onboardDateTime of the governanceResource entity to registeredDateTime.
Addition beta Added new action register resource.
Removal beta Removed the isPermanent property on governanceRoleAssignment entity.
Removal beta Removed the roleAssignmentStartDateTime property on governanceRoleAssignmentRequest entity.
Removal beta Removed the roleAssignmentEndDateTime property on governanceRoleAssignmentRequest entity.

November 2018

Data Policy Operations API

Change type Version Description
Addition beta Added new progress property to dataPolicyOperation. This specifies the progress of an operation.

Microsoft Teams APIs

Change type Version Description
Addition v1.0 Introduced new resource type team.
Addition v1.0 Introduced new resource type channel.
Addition v1.0 Introduced new resource type teamsApp.
Addition v1.0 Introduced new resource type teamsAppDefinition.
Addition v1.0 Introduced new resource type teamsAppInstallation.
Addition v1.0 Introduced new resource type teamsAsyncOperation.
Addition v1.0 Introduced new complex type teamGuestSettings.
Addition v1.0 Introduced new complex type teamMemberSettings.
Addition v1.0 Introduced new complex type teamMessagingSettings.
Addition v1.0 Introduced new complex type teamFunSettings.
Addition v1.0 Introduced new action Clone team.
Addition v1.0 Introduced new action Archive team.
Addition v1.0 Introduced new action Unarchive team.
Addition Beta Added application permissions support to clone team.
Addition beta Introduced /teams/{id}/installedApps, which will replace /teams/{id}/apps with some differences in payload.
Addition beta Introduced /appCatalogs/teamsApps/{id}/appDefinition, which will replace the version property on /appCatalogs/teamsApps/{id}.
Change beta Renamed the type of /appCatalogs/teamsApps from teamsCatalogApp to teamsApp.
Change beta Renamed the type of the distributionMethod property on /appCatalogs/teamsApps from teamsCatalogAppDistributionMethod to teamsAppDistributionMethod
Removal beta teamsCatalogAppDistributionMethod has been renamed to teamsAppDistributionMethod
Addition beta Introduced /teams/{id}/installedApps, which will replace /teams/{id}/apps with some differences in payload.
Addition beta Added the displayName property to teamsTab
Addition beta Added the messageId property to teamsTab
Addition beta Added the teamsApp property to teamsTab
Addition beta Introduced new resource type teamsAppInstallation.
Addition beta Introduced new resource type teamsApp.
Addition beta Introduced new resource type teamsAppDefinition.
Addition beta Introduced new enum member hiddenMembership to teamVisibilityType.
Addition beta Introduced new enum member createTeam to teamsAsyncOperationType.
Addition beta Introduced new enum member teamsAppDistributionMethod.
Addition beta Introduced new upgrade app action under /teams/{id}/installedApps.

Directory APIs

Change type Version Description
Addition v1.0 Added the forceDelete action to domains.
Addition beta Added new method transitiveMembers on groups. This method returns a flat list of members including nested members.
Addition beta Added new method transitiveMemberOf on users, groups, devices and service principals.
Addition beta Added method memberOf to get a devices direct membership. This method has been added for getting the list of memberships including nested memberships.
Addition beta Added new properties to users: faxNumber, onPremisesDistinguishedName, and otherMails.
Addition beta Added the forceChangePasswordNextSignInWithMfa property to the passwordProfile complex type.

Reports APIs

Change type Version Description
Addition Beta version in Microsoft Graph China operated by 21Vianet Added the following APIs:
getEmailActivityUserDetail
getEmailActivityCounts
getEmailActivityUserCounts
getEmailAppUsageUserDetail
getEmailAppUsageAppsUserCounts
getEmailAppUsageUserCounts
getEmailAppUsageVersionsUserCounts
getMailboxUsageDetail
getMailboxUsageMailboxCounts
getMailboxUsageQuotaStatusMailboxCounts
getMailboxUsageStorage
getOffice365ActivationsUserDetail
getOffice365ActivationCounts
getOffice365ActivationsUserCounts
getOffice365ActiveUserDetail
getOffice365ActiveUserCounts
getOffice365ServicesUserCounts
getOffice365GroupsActivityDetail
getOffice365GroupsActivityCounts
getOffice365GroupsActivityGroupCounts
getOffice365GroupsActivityStorage
getOffice365GroupsActivityFileCounts
getOneDriveActivityUserDetail
getOneDriveActivityUserCounts
getOneDriveActivityFileCounts
getOneDriveUsageAccountDetail
getOneDriveUsageAccountCounts
getOneDriveUsageFileCounts
getOneDriveUsageStorage
getSharePointActivityUserDetail
getSharePointActivityFileCounts
getSharePointActivityUserCounts
getSharePointActivityPages
getSharePointSiteUsageDetail
getSharePointSiteUsageFileCounts
getSharePointSiteUsageSiteCounts
getSharePointSiteUsageStorage
getSharePointSiteUsagePages
getSkypeForBusinessActivityUserDetail
getSkypeForBusinessActivityCounts
getSkypeForBusinessActivityUserCounts
getSkypeForBusinessDeviceUsageUserDetail
getSkypeForBusinessDeviceUsageDistributionUserCounts
getSkypeForBusinessDeviceUsageUserCounts
getSkypeForBusinessOrganizerActivityCounts
getSkypeForBusinessOrganizerActivityUserCounts
getSkypeForBusinessOrganizerActivityMinuteCounts
getSkypeForBusinessParticipantActivityCounts
getSkypeForBusinessParticipantActivityUserCounts
getSkypeForBusinessParticipantActivityMinuteCounts
getSkypeForBusinessPeerToPeerActivityCounts
getSkypeForBusinessPeerToPeerActivityUserCounts
getSkypeForBusinessPeerToPeerActivityMinuteCounts.

Directory APIs

Change type Version Description
Addition Beta Added the 'externalUserState' and 'externalUserStateChangeDateTime' properties to the user object.

October 2018

Directory APIs

Change type Version Description
Addition beta Added new method transitiveMembers on groups. This method returns a flat list of members including nested members.
Addition beta Added new method transitiveMemberOf on users, groups, devices and service principals.
Addition beta Added method memberOf to get a devices direct membership. This method has been added for getting the list of memberships including nested memberships.
Addition beta Added new properties to users: faxNumber, onPremisesDistinguishedName, and otherMails.

RiskyUsers APIs

Change type Version Description
Addition beta Introduced riskyUsers API, which represents Azure AD users who are at risk, as detected by Azure AD Identity Protection.

SignIn APIs

Change type Version Description
Change beta Renamed the property conditionalAccessPolicies to appliedConditionalAccessPolicy.
Addition beta Introduced additional risk properties in the signIn API, including riskDetail, riskLevelAggregated, riskLevelDuringSignIn, riskEventTypes, and riskState.
Addition beta Introduced additional sign-in properties in the signIn API, including authenticationProcessingDetails, originalRequestID, isInteractive, tokenIssuerName, tokenIssuerType, correlationId, and processingTimeinMilliseconds.
Removal beta Removed the property isRisky.

October 2018

Delta query

Change type Version Description
Addition Beta Added delta query capability for directoryObject
Change v1.0 and beta Alternative behavior to return changed properties only in JSON response for users and groups.
Addition v1.0 Added delta function for directoryRole to support change tracking using delta query.

Directory APIs

Change type Version Description
Addition Beta Added the licenseAssignmentStates property to the User entity for Group Based Licensing.
Addition Beta Added the licenseAssignmentState resource for Group Based Licensing.
Addition Beta Added the assignedLicenses, licenseProcessingState, hasMembersWithLicenseErrors and membersWithLicenseErrors properties to Group entity for Group Based Licensing.

Microsoft Intune APIs

Change type Version Description
Addition v1.0 Added the tenantLockdownRequireNetworkDuringOutOfBoxExperience property to the windows10GeneralConfiguration entity
Addition v1.0 Added the v12_0 property to the iosMinimumOperatingSystem complex type
Addition beta Added the lastReportAggregationDateTime property to the deviceManagement entity
Addition beta Added new entities:
intuneBrandingProfile
Addition beta Added new complex types:
deviceAndAppManagementAssignedRoleIds
Addition beta Added new enum types:
applicationGuardEnabledOptions
autoRestartNotificationDismissalMethod
meteredConnectionLimitType
Addition beta Added the enableLegacyPcManagement action on deviceManagement
Addition beta Added the extendFeatureUpdatesPause action on windowsUpdateForBusinessConfiguration
Addition beta Added the extendQualityUpdatesPause action on windowsUpdateForBusinessConfiguration
Addition beta Added the unassignUserFromDevice action on windowsAutopilotDeviceIdentity
Addition beta Added the getAssignedRoleIdsForLoggedInUser function on deviceManagement
Addition beta Added the getManagedDevicesWithAppFailures function on user
Addition beta Added the managedDeviceEnrollmentAbandonmentSummary function on reportRoot
Addition beta Added the managedDeviceEnrollmentAbandonmentDetails function on reportRoot
Deletion beta Removed the subjectAlternativeNameType property from the androidForWorkCertificateProfileBase entity
Addition beta Added the subjectAlternativeNameType property to the androidForWorkPkcsCertificateProfile entity
Addition beta Added the certificateStore, customSubjectAlternativeNames and subjectAlternativeNameType properties to the androidForWorkScepCertificateProfile entity
Deletion beta Removed the subjectAlternativeNameType property from the androidWorkProfileCertificateProfileBase entity
Addition beta Added the subjectAlternativeNameType property to the androidWorkProfilePkcsCertificateProfile entity
Addition beta Added the certificateStore, customSubjectAlternativeNames and subjectAlternativeNameType properties to the androidWorkProfileScepCertificateProfile entity
Addition beta Added the legacyPcManangementEnabled property to the deviceManagement entity
Deletion beta Removed the pinRequiredOnLaunchInsteadOfBiometric property from the managedAppProtection entity
Addition beta Added the roleScopeTagIds property to the managedDeviceMobileAppConfiguration entity
Addition beta Added the applicationGuardEnabledOptions property to the windows10EndpointProtectionConfiguration entity
Addition beta Added the selectedMobileAppIds property to the windows10EnrollmentCompletionPageConfiguration entity
Addition beta Added the engagedRestartDeadlineInDays, engagedRestartSnoozeScheduleInDays, engagedRestartTransitionScheduleInDays, autoRestartNotificationDismissal, scheduleRestartWarningInHours and scheduleImminentRestartWarningInMinutes properties to the windowsUpdateForBusinessConfiguration entity
Addition beta Added the preSharedKey and meteredConnectionLimit properties to the windowsWifiConfiguration entity
Addition beta Added the intuneBrandingProfiles navigation property to the deviceManagement entity
Addition beta Added the v6_0, v7_0, v7_1, v8_0, v8_1 and v9_0 properties to the androidMinimumOperatingSystem complex type
Addition beta Added the v12_0 property to the iosMinimumOperatingSystem complex type
Deletion beta Removed the runAsLoggedOnUser property from the win32LobAppPowerShellScriptDetection complex type
Addition beta Added the lastUpdateDateTime property to the osVersionCount complex type
Addition beta Added the lastUpdateDateTime property to the windowsMalwareCategoryCount complex type
Addition beta Added the lastUpdateDateTime property to the windowsMalwareExecutionStateCount complex type
Addition beta Added the lastUpdateDateTime property to the windowsMalwareNameCount complex type
Addition beta Added the lastUpdateDateTime property to the windowsMalwareStateCount complex type

Privileged Identity Management APIs

Change type Version Description
Change beta Change the privilegedapproval entity.
Addition beta Added the privilegedroleassignmentrequest entity, and following methods and actions:
List
Create
Cancel
My
Addition beta Added Update for privilegedRoleSettings
Removal beta Deprecated the Self Activate Role Assignment

Microsoft Teams APIs

Change type Version Description
Addition beta Added application permissions support to archive team and unarchive team APIs.

Outlook contacts

Change type Version Description
Removal v1.0 This is a correction to the documentation: removed the flag property from the contact entity topic. The property was never made available in the contact entity.

Reports APIs

Change type Version Description
Addition v1.0 Added the Site ID property to getSharePointSiteUsageDetail.

September 2018

Calls and online meetings API

Change type Version Description
Change Beta The application resource was updated to add a calls collection.
Change Beta The operation resource was updated to support long-running calls and meetings APIs.
Addition Beta Added the call resource for managing audio/video calls (initially, in Microsoft Teams), including APIs for creating calls, retrieving a a call, deleting (hanging up) a call, answering a call, rejecting a call, redirecting a call, and transferring a call. We've also added APIs to support IVR scenarios: playing a prompt, recording a call, cancel media processing, and subscribing to touch tone notifications.
Addition Beta Added the participant resource and APIs for managing the participants in audio/video calls and meetings, including retrieving a participant object, configuring the audio mixer for a participant, muting one or all of the participants, retrieving a list of the participants in a call/meeting, and inviting participants to a call/meeting.
Addition Beta Added APIs for applications to manage and participate in calls and meetings, including the ability to share content, mute and unmute itself, and update the metadata associated with a call.
Addition Beta Added the audio routing group resource and APIs for managing private audio routes between participants in a multiparty conversation, including creating audio routing groups, retrieving a list of them, and updating and deleting them.
Addition Beta Added the online meeting resource and APIs for managing Microsoft Teams online meetings. Initially, there is only one API for online meetings, to retrieve an online meeting object. A related resource for the audio conference information associated with a meeting (e.g. dial-in URL, passcodes, and phone numbers) was also added.
Addition Beta Many of the calls and meetings APIs take time to complete, so resources for these long-running operations were added: calling-specific operations, playing audio prompts, and recording.

Dynamics 365 Business Central API

Change type Version Description
Addition Beta Added financials APIs for Dynamics 365 Business Central. For details, see the Financials API reference

Microsoft Graph data connect

Change type Version Description
Addition Not applicable Introduced the ability to access Office 365 data in bulk. For details, see Microsoft Graph data connect (preview).

Microsoft Intune APIs

Change type Version Description
Addition v1.0 Added the assign action on managedDeviceMobileAppConfiguration
Addition beta Added new entities:
officeClientConfiguration
officeClientConfigurationAssignment
officeConfiguration
windowsOfficeClientConfiguration
windowsOfficeClientSecurityConfiguration
Addition beta Added new complex types:
officeClientCheckinStatus
officeConfigurationAssignmentTarget
officeConfigurationGroupAssignmentTarget
officeUserCheckinSummary
Addition beta Added the assign action on officeClientConfiguration
Addition beta Added the updatePrioritie action on officeClientConfiguration collection
Addition beta Added new entities:
deviceConfigurationConflictSummary
importedWindowsAutopilotDeviceIdentityUpload
win32LobApp
Addition beta Added new complex types:
deviceConfigurationTargetedUserAndDevice
win32LobAppDetection
win32LobAppFileSystemDetection
win32LobAppInstallExperience
win32LobAppMsiInformation
win32LobAppPowerShellScriptDetection
win32LobAppProductCodeDetection
win32LobAppRegistryDetection
win32LobAppReturnCode
windows10AppsForceUpdateSchedule
Addition beta Added new enum types:
administratorConfiguredDeviceComplianceState
importedWindowsAutopilotDeviceIdentityUploadStatus
microsoftStoreForBusinessPortalSelectionOptions
win32LobAppDetectionOperator
win32LobAppFileSystemDetectionType
win32LobAppMsiPackageType
win32LobAppRegistryDetectionType
win32LobAppReturnCodeType
windows10AppsUpdateRecurrence
windowsAppStartLayoutTileSize
windowsAutopilotProfileAssignmentDetailedStatus
Addition beta Added the overrideComplianceState action on managedDevice
Addition beta Added the getTargetedUsersAndDevices action on deviceConfiguration collection
Addition beta Added the autopilotDeviceStream function on importedWindowsAutopilotDeviceIdentityUpload
Addition beta Added the restrictedApps property to the androidCompliancePolicy entity
Addition beta Added the tokenCreationDateTime property to the androidDeviceOwnerEnrollmentProfile entity
Deletion beta Removed the restrictedApps property from the androidForWorkCompliancePolicy entity
Deletion beta Removed the restrictedApps property from the androidWorkProfileCompliancePolicy entity
Change beta Changed the following properties on the appleVpnConfiguration entity:
enablePerApp from required to optional
Addition beta Added the disableProtectionOfManagedOutboundOpenInData and protectInboundDataFromUnknownSources properties to the defaultManagedAppProtection entity
Addition beta Added the microsoftStoreForBusinessPortalSelection property to the deviceAppManagement entity
Addition beta Added the passcodeMinutesOfInactivityBeforeScreenTimeout property to the iosCompliancePolicy entity
Addition beta Added the useOAuth property to the iosEasEmailProfileConfiguration entity
Addition beta Added the kioskModeBlockVolumeButtons, classroomForceRequestPermissionToLeaveClasses, keychainBlockCloudSync, pkiBlockOTAUpdates, privacyForceLimitAdTracking, enterpriseBookBlockBackup, enterpriseBookBlockMetadataSync, airPrintBlocked, airPrintBlockCredentialsStorage, airPrintForceTrustedTLS, airPrintBlockiBeaconDiscovery, blockSystemAppRemoval and vpnBlockCreation properties to the iosGeneralDeviceConfiguration entity
Addition beta Added the disableProtectionOfManagedOutboundOpenInData and protectInboundDataFromUnknownSources properties to the iosManagedAppProtection entity
Addition beta Added the gatekeeperAllowedAppSource property to the macOSCompliancePolicy entity
Addition beta Added the keychainBlockCloudSync, airPrintBlocked, airPrintForceTrustedTLS and airPrintBlockiBeaconDiscovery properties to the macOSGeneralDeviceConfiguration entity
Addition beta Added the deviceModel and deviceManufacturer properties to the managedAppRegistration entity
Addition beta Added the enabledForScopeValidation property to the resourceOperation entity
Addition beta Added the claimTokenManagementFromExternalMdm property to the vppToken entity
Addition beta Added the windows10AppsForceUpdateSchedule property to the windows10GeneralConfiguration entity
Addition beta Added the deploymentProfileAssignmentDetailedStatus property to the windowsAutopilotDeviceIdentity entity
Addition beta Added the deviceConfigurationConflictSummary and importedWindowsAutopilotDeviceIdentityUploads navigation properties to the deviceManagement entity
Addition beta Added the intendedDeploymentProfile navigation property to the windowsAutopilotDeviceIdentity entity
Addition beta Added the startLayoutTileSize and name properties to the windowsKioskAppBase complex type
Addition beta Added the desktopApplicationId and desktopApplicationLinkPath properties to the windowsKioskDesktopApp complex type
Deletion beta Removed the name property from the windowsKioskDesktopApp complex type
Addition beta Added the disallowDesktopApps property to the windowsKioskMultipleApps complex type
Change beta Changed the following properties on the windowsKioskMultipleApps complex type:
startMenuLayoutXml from required to optional
Addition beta Added the v10_1607, v10_1703, v10_1709 and v10_1803 properties to the windowsMinimumOperatingSystem complex type
Addition beta Added the paloAltoGlobalProtect member to the androidWorkProfileVpnConnectionType enum type
Addition beta Added the remoteLock member to the deviceComplianceActionType enum type

Microsoft Teams APIs

Change type Version Description
Addition beta Added API for Tabs.
Addition beta Added API for publishing apps for your organization.
Addition beta Added application permissions support to GET /teams/{id}.
Addition beta Added application permissions support to GET /teams/{id}/channels.
Addition beta Added application permissions support to GET /teams/{id}/channels/{id}.
Addition beta Added application permissions support to PUT /groups/{id}/team.
Addition beta Added application permissions support to PATCH /teams/{id}.
Addition beta Added application permissions support to Create channel, Update channel, and Delete channel.
Deletion beta Removed isBlocks and installedState properties from teamsApp.
Change beta The context property on teamsApp has been renamed to distributionMethod.

Outlook mail

Change type Version Description
Addition v1.0 and beta The internetMessageHeaders property of the message entity is now writeable on message creation.

Project Rome notifications API

Change type Version Description
Addition Beta Added the notification resource type.
Addition Beta Added the [Create and publish notification] (/graph/api/projectrome_notification_post?view=graph-rest-beta) API.

Security APIs

Change type Version Description
Addition Beta Added the Secure Score APIs to the security API, including the following resources and operations:
secureScores (and related entities)
List secureScores
secureScoreControlProfiles
List secureScoreControlProfiles
Update secureScoreControlProfiles

OneDrive and SharePoint APIs

Change type Version Description
Addition Beta Added the deferCommit argument to the createUploadSession action on driveItem
Addition Beta Added the storagePlanInformation complex type
Addition Beta Added the storagePlanInformation property to the quota complex type
Addition Beta Added the following navigation property to the drive entity
Addition Beta Added the follow action on driveItem
Addition Beta Added the unfollow API
Addition Beta Added the hasPassword property to the permission entity
Addition Beta Added the preventsDownload property to the sharingLink complex type
Addition Beta Added the permission navigation property to the sharedDriveItem entity
Addition Beta Added the geolocation property to the columnDefinition entity
Addition Beta Added the geolocationColumn complex type
Addition Beta Added the analytics property to the driveItem entity
Addition Beta Added the analytics property to the site entity
Addition Beta Added the analytics property to the listItem entity
Addition Beta Added the getActivitiesByInterval function on the driveItem entity
Addition Beta Added the getActivitiesByInterval function on the site entity
Addition Beta Added the getActivitiesByInterval function on the listItem entity
Addition Beta Added the itemAnalytics entity
Addition Beta Added the itemActivityStat entity
Addition Beta Added the itemActionStat complex type
Addition Beta Added the accessAction complex type
Addition Beta Added the incompleteData complex type
Addition Beta Added the access property to the itemActivity complex type
Addition Beta Added the location property to the itemActivity complex type
Addition v1.0 Added the preview action on the driveItem entity
Addition v1.0 Added the itemPreviewInfo complex type

August 2018

Delta query

Change type Version Description
Addition Beta Added delta query capability for the following entities in Azure AD:
application
directoryRole
servicePrincipal

Directory APIs

Change type Version Description
Addition v1.0 Added isMultipleDataLocationsForServicesEnabled property to Organization resource that allows apps to verify that tenant is enabled for Multi-Geo capabilities. Added preferredDataLocation property to user and group resources that allow setting preferred data location for a user and group.
Addition v1.0 Added onPremisesProvisioningErrors property to the User and Group entities that represents directory synchronization errors when synchronizing on-premises directories to Azure Active Directory when using Microsoft synchronization product (including Azure AD Connect, DirSync and MIM + Connector).
Addition v1.0 Added onPremisesExtensionAttributes property to the User entity that contains fifteen custom extension attribute properties. For an onPremisesSyncEnabled user, this set of properties is mastered in on-premises Active Directory and synchronized to Azure AD, and is read-only. For a cloud-only user (where onPremisesSyncEnabled is false), these properties may be set during creation or update.
Addition v1.0 Added the onPremisesDomainName, onPremisesSamAccountName, and onPremisesUserPrincipalName properties to the User entity

Microsoft Intune APIs

Change type Version Description
Addition v1.0 Added new entities:
androidWorkProfileCompliancePolicy
androidWorkProfileCustomConfiguration
androidWorkProfileGeneralDeviceConfiguration
Addition v1.0 Added new enum types:
androidWorkProfileCrossProfileDataSharingType
androidWorkProfileDefaultAppPermissionPolicyType
androidWorkProfileRequiredPasswordType
Addition v1.0 Added the managedDeviceEnrollmentFailureDetails function on reportRoot
Addition v1.0 Added the managedDeviceEnrollmentTopFailures function on reportRoot
Addition v1.0 Added the kioskModeBuiltInAppId property to the iosGeneralDeviceConfiguration entity
Addition v1.0 Added the notAssigned member to the complianceStatus enum type
Addition v1.0 Added the pushNotification member to the deviceComplianceActionType enum type
Addition v1.0 Added the userAbandonment member to the deviceEnrollmentFailureReason enum type
Addition v1.0 Added the compromised and misconfigured members to the managedDevicePartnerReportedHealthState enum type
Addition v1.0 Added the assignedToExternalMDM member to the vppTokenState enum type
Addition beta Added new entities:
advancedThreatProtectionOnboardingDeviceSettingState
advancedThreatProtectionOnboardingStateSummary
depEnrollmentBaseProfile
depEnrollmentProfile
depIOSEnrollmentProfile
depMacOSEnrollmentProfile
enrollmentProfile
importedAppleDeviceIdentity
importedAppleDeviceIdentityResult
importedWindowsAutopilotDeviceIdentityUpload
roleScopeTag
windowsIdentityProtectionConfiguration
Addition beta Added new complex types:
configurationManagerClientHealthState
customSubjectAlternativeName
deviceManagementUserRightsLocalUserOrGroup
deviceManagementUserRightsSetting
managementCertificateWithThumbprint
mobileAppSupportedDeviceType
osVersionCount
windowsMalwareCategoryCount
windowsMalwareExecutionStateCount
windowsMalwareNameCount
windowsMalwareOverview
windowsMalwareStateCount
Addition beta Added new enum types:
configurationManagerClientState
depTokenType
discoverySource
importedWindowsAutopilotDeviceIdentityUploadStatus
iTunesPairingMode
lanManagerAuthenticationLevel
localSecurityOptionsMinimumSessionSecurity
resultantAppStateDetail
vpnProviderType
windowsMalwareThreatState
Addition beta Added the uploadDepToken action on depOnboardingSetting
Addition beta Added the syncWithAppleDeviceEnrollmentProgram action on depOnboardingSetting
Addition beta Added the setDefaultProfile action on enrollmentProfile
Addition beta Added the importAppleDeviceIdentityList action on importedAppleDeviceIdentity collection
Addition beta Added the updateDeviceProfileAssignment action on enrollmentProfile
Addition beta Added the shareForSchoolDataSyncService action on depOnboardingSetting
Addition beta Added the unshareForSchoolDataSyncService action on depOnboardingSetting
Addition beta Added the assignUserToDevice action on windowsAutopilotDeviceIdentity
Addition beta Added the getRoleScopeTagsByResource function on deviceManagement
Addition beta Added the getRoleScopeTagsByIds function on deviceManagement
Addition beta Added the getEncryptionPublicKey function on depOnboardingSetting
Addition beta Added the exportMobileConfig function on enrollmentProfile
Addition beta Added the autopilotDeviceStream function on importedWindowsAutopilotDeviceIdentityUpload
Deletion beta Removed the uploadDepToken collection
Deletion beta Removed the syncWithAppleDeviceEnrollmentProgram action on depOnboardingSetting collection
Deletion beta Removed the getEncryptionPublicKey function on depOnboardingSetting collection
Addition beta Added the restrictedApps property to the androidForWorkCompliancePolicy entity
Addition beta Added the vpnAlwaysOnPackageIdentifier and vpnEnableAlwaysOnLockdownMode properties to the androidForWorkGeneralDeviceConfiguration entity
Deletion beta Removed the packageName property from the androidForWorkMobileAppConfiguration entity
Addition beta Added the restrictedApps property to the androidWorkProfileCompliancePolicy entity
Addition beta Added the vpnAlwaysOnPackageIdentifier and vpnEnableAlwaysOnLockdownMode properties to the androidWorkProfileGeneralDeviceConfiguration entity
Addition beta Added the optInToDeviceIdSharing property to the appleVpnConfiguration entity
Addition beta Added the tokenType, tokenName, syncedDeviceCount, defaultProfileDisplayName and dataSharingConsentGranted properties to the depOnboardingSetting entity
Addition beta Added the roleScopeTagIds property to the deviceCompliancePolicy entity
Addition beta Added the roleScopeTagIds and supportsScopeTags properties to the deviceConfiguration entity
Addition beta Added the windowsMalwareOverview property to the deviceManagement entity
Change beta Changed the following properties on the iosCertificateProfileBase entity:
subjectAlternativeNameType from required to optional
Addition beta Added the restrictedApps property to the iosCompliancePolicy entity
Addition beta Added the certificateStore and customSubjectAlternativeNames properties to the iosScepCertificateProfile entity
Addition beta Added the enforcedSoftwareUpdateDelayInDays property to the iosUpdateConfiguration entity
Addition beta Added the providerType, userDomain, strictEnforcement, cloudName and excludeList properties to the iosVpnConfiguration entity
Addition beta Added the safariBlockAutofill, cameraBlocked, iTunesBlockMusicService, spotlightBlockInternetResults, keyboardBlockDictation, definitionLookupBlocked, appleWatchBlockAutoUnlock, iTunesBlockFileSharing, iCloudBlockDocumentSync, iCloudBlockMail, iCloudBlockAddressBook, iCloudBlockCalendar, iCloudBlockReminders, iCloudBlockBookmarks, iCloudBlockNotes, airDropBlocked, passwordBlockModification and passwordBlockFingerprintUnlock properties to the macOSGeneralDeviceConfiguration entity
Addition beta Added the roleScopeTagIds, windowsActiveMalwareCount, windowsRemediatedMalwareCount, notes and configurationManagerClientHealthState properties to the managedDevice entity
Addition beta Added the installStateDetail property to the mobileAppInstallStatus entity
Addition beta Added the roleScopeTagIds property to the notificationMessageTemplate entity
Addition beta Added the targetVersion and updateVersion properties to the officeSuiteApp entity
Addition beta Added the resource property to the resourceOperation entity
Addition beta Added the localStorage, setPowerPolicies and signInOnResume properties to the sharedPCConfiguration entity
Addition beta Added the configurationManagerComplianceRequired property to the windows10CompliancePolicy entity
Addition beta Added the userRightsAccessCredentialManagerAsTrustedCaller, userRightsAllowAccessFromNetwork, userRightsBlockAccessFromNetwork, userRightsActAsPartOfTheOperatingSystem, userRightsLocalLogOn, userRightsBackupData, userRightsChangeSystemTime, userRightsCreateGlobalObjects, userRightsCreatePageFile, userRightsCreatePermanentSharedObjects, userRightsCreateSymbolicLinks, userRightsCreateToken, userRightsDebugPrograms, userRightsRemoteDesktopServicesLogOn, userRightsDelegation, userRightsGenerateSecurityAudits, userRightsImpersonateClient, userRightsIncreaseSchedulingPriority, userRightsLoadUnloadDrivers, userRightsLockMemory, userRightsManageAuditingAndSecurityLogs, userRightsManageVolumes, userRightsModifyFirmwareEnvironment, userRightsModifyObjectLabels, userRightsProfileSingleProcess, userRightsRemoteShutdown, userRightsRestoreData, userRightsTakeOwnership, userRightsRegisterProcessAsService, localSecurityOptionsMinimumSessionSecurityForNtlmSspBasedClients, localSecurityOptionsMinimumSessionSecurityForNtlmSspBasedServers, lanManagerAuthenticationLevel and lanManagerWorkstationEnableInsecureGuestLogons properties to the windows10EndpointProtectionConfiguration entity
Addition beta Added the passwordMinimumAgeInDays, tenantLockdownRequireNetworkDuringOutOfBoxExperience and dataProtectionBlockDirectMemoryAccess properties to the windows10GeneralConfiguration entity
Addition beta Added the extendedKeyUsages property to the windows10PkcsCertificateProfile entity
Addition beta Added the enableDnsRegistration and dnsSuffixes properties to the windows10VpnConfiguration entity
Addition beta Added the customSubjectAlternativeNames property to the windows81CertificateProfileBase entity
Addition beta Added the extractHardwareHash and deviceNameTemplate properties to the windowsAutopilotDeploymentProfile entity
Addition beta Added the addressableUserName and userPrincipalName properties to the windowsAutopilotDeviceIdentity entity
Addition beta Added the threatState property to the windowsDeviceMalwareState entity
Addition beta Added the qualityUpdatesPauseStartDateTime, featureUpdatesPauseStartDateTime, featureUpdatesRollbackWindowInDays, qualityUpdatesWillBeRolledBack, featureUpdatesWillBeRolledBack, qualityUpdatesRollbackStartDateTime and featureUpdatesRollbackStartDateTime properties to the windowsUpdateForBusinessConfiguration entity
Addition beta Added the trustedServerCertificateNames property to the windowsWifiEnterpriseEAPConfiguration entity
Addition beta Added the defaultIosEnrollmentProfile, defaultMacOsEnrollmentProfile, enrollmentProfiles and importedAppleDeviceIdentities navigation properties to the depOnboardingSetting entity
Addition beta Added the roleScopeTags navigation property to the deviceAndAppManagementRoleAssignment entity
Addition beta Added the advancedThreatProtectionOnboardingStateSummary, roleScopeTags and importedWindowsAutopilotDeviceIdentityUploads navigation properties to the deviceManagement entity
Addition beta Added the supportedDeviceTypes property to the mobileAppIntentAndStateDetail complex type
Addition beta Added the hideEscapeLink property to the outOfBoxExperienceSettings complex type
Addition beta Added the zscalerPrivateAccess, f5Access2018, citrixSso and paloAltoGlobalProtectV2 members to the appleVpnConnectionType enum type
Addition beta Added the userAbandonment member to the deviceEnrollmentFailureReason enum type
Addition beta Added the blocked member to the enrollmentState enum type
Addition beta Added the microsoft365ManagedMdm member to the managementAgentType enum type
Addition beta Added the domainNameService member to the subjectAlternativeNameType enum type
Addition beta Added the wpa2Personal and wpa2Enterprise members to the wiFiSecurityType enum type
Addition beta Added the enterpriseUnwantedSoftware, ransom and hipsRule members to the windowsMalwareCategory enum type

Outlook calendar

Change type Version Description
Addition Beta Added the getSchedule action, and the freeBusyError, scheduleInformation, and scheduleItem complex types to support getting the free/busy, availability information for users, distribution lists, and resources for a given period of time.

Outlook mail

Change type Version Description
Addition v1.0 Added support for the getMailTips action to get any MailTips for specific recipients. Added the following resources: automaticRepliesMailTips, mailTips, mailTipsError.

Reports APIs

Change type Version Description
Addition v1.0 Added the Activated On Shared Computer property to getoffice365activationsuserdetail.
Addition v1.0 Added the Shared Computer Activation property to getoffice365activationsusercounts.

Security APIs

Change type Version Description
Addition beta Added activityGroupName, cloudAppStates, confidence, and registryKeyStates properties to alert.
Deletion beta Removed activityGroupStates, applicationStates, malwareWasRunning, riskScore and type properties from alert.
Change beta Changed comments type from a String to a String collection, and changed severity type from a String to a alertSeverity enum in alert.
Addition beta Added the following resource types:
cloudAppSecurityState
fileHash
registryKeyState
Deletion beta Removed the following resource types:
activityGroupState
applicationSecurityState
Addition beta Added the following enums:
alertSeverity
connectionDirection
connectionStatus
emailRole
fileHashType
registryHive
registryOperation
registryValueType
Deletion beta Removed the following enum types:
alertType
applicationPermissionsRequired
Addition beta Added fileHash property to fileSecurityState.
Deletion beta Removed authenticodeHash256 and sha256 properties from fileSecurityState.
Addition beta Added os property to hostSecurityState.
Addition beta Added category, family, and wasRunning properties to malwareState.
Deletion beta Removed aliases property from malwareState.
Change beta Moved malwareWasRunning property from alert to malwareState and renamed to wasRunning.
Addition beta Added applicationName, destinationDomain, direction, domainRegisteredDateTime, localDnsName, natDestinationAddress, natDestinationPort, natSourceAddress, natSourcePort, riskScore, status, and urlParameters properties to networkConnection.
Change beta Changed uri property to destinationUrl in networkConnection.
Addition beta Added fileHash property to process.
Deletion beta Removed authenticodeHash256 and sha256 properties from process.
Addition beta Added aadUserId, emailRole, isVpn, and logonIp properties to userSecurityState.
Change beta Changed logonIpAddress property to logonIp in userSecurityState.
Addition beta Added wasRunning property to vulnerabilityState.
Deletion beta Removed name property from vulnerabilityState.

July 2018

Directory APIs

Change type Version Description
Change beta Updated chatmessage resource
Addition beta Added Chat attachment resource type
Addition beta Added Chat mention resource type
Addition beta Added Chat reaction resource type
Addition beta Added Get all channel messages API
Addition beta Added Get channel message API
Addition beta Added Get all message replies API
Addition beta Added Get reply to a message API

Synchronization APIs

Change type Version Description
Addition Beta Added progress property to sychronizationStatus to permit clients to monitor the progress of a synchronization job.

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 July 16, 2018. The changes include property renaming and restructuring. Most of the existing properties will not be available until the changes are completed. There will be new properties added. The changes will be released in preview (beta) prior to releasing to v1.0.

Microsoft Teams APIs

Change type Version Description
Addition beta Added application permissions support to /users/{id}/joinedTeams
Addition beta Added Get all channel messages API
Addition beta Added Get channel message API
Addition beta Added Get all message replies API
Addition beta Added Get reply to a message API
Addition beta Added Chat attachment resource type
Addition beta Added Chat mention resource type
Addition beta Added Chat reaction resource type
Change beta Updated chatmessage) resource
Deletion beta Removed DELETE /groups/{id}/team/channels/{id}, use DELETE /teams/{id}/channels/{id} instead.
Deletion beta Removed GET /groups/{id}/team/channels/{id}, use GET /teams/{id}/channels/{id} instead.
Deletion beta Removed PATCH /groups/{id}/team/channels/{id}, use PATCH /teams/{id}/channels/{id} instead.
Deletion beta Removed POST /groups/{id}/team/channels/{id}/chatthreads, use POST /teams/{id}/channels/{id}/chatthreads instead.
Deletion beta Removed GET /groups/{id}/team/channels, use GET /teams/{id}/channels instead.
Deletion beta Removed DELETE /groups/{id}/channels/{id} , use DELETE /teams/{id}/channels/{id} instead.
Deletion beta Removed GET /groups/{id}/channels/{id}, use GET /teams/{id}/channels/{id} instead.
Deletion beta Removed PATCH /groups/{id}/channels/{id}, use PATCH /teams/{id}/channels/{id} instead.
Deletion beta Removed POST /groups/{id}/channels/{id}/chatthreads, use POST /teams/{id}/channels/{id}/chatthreads instead.
Deletion beta Removed GET /groups/{id}/channels, use GET /teams/{id}/channels instead.
Deletion beta Removed POST /groups/{id}/team/channels, use POST /teams/{id}/channels instead.
Deletion beta Removed GET /groups/{id}/team, use GET /teams/{id} instead.
Deletion beta Removed PATCH /groups/{id}/team, use PATCH /teams/{id} instead.
Addition beta Added API to list all teams in organization.

Outlook contacts

Change type Version Description
Addition Beta Added the complex type typedEmailAddress.
Change Beta Changed the type of the emailAddresses property of contact to be a collection of typedEmailAddress instances.

Webhooks

Change type Version Description
Breaking change Beta and v1.0 Reduced webhooks maximum length of subscription expiration time for drive root items to 3 days.

June 2018

Identity and access APIs

Change type Version Description
Addition beta Added the access reviews feature to Azure AD.

Directory APIs

Change type Version Description
Addition All New application permissions Application.ReadWrite.All and Application.ReadWrite.OwnedBy that allows a client app to create, read, update, and delete applications and service principals as described in the permissions topic.
Addition v1.0 Added ageGroup, legalAgeGroupClassification, and ConsentRequiredForMinor properties to user resource

Microsoft Intune APIs

Change type Version Description
Addition v1.0 Added the connectorServerName property to the deviceManagementExchangeConnector entity
Addition v1.0 Added the firewallEnabled, firewallBlockAllIncoming and firewallEnableStealthMode properties to the macOSCompliancePolicy entity
Addition v1.0 Added the unknown member to the iosUpdatesInstallStatus enum type
Addition beta Added new entities:
androidDeviceOwnerWiFiConfiguration
iosVppAppAssignedDeviceLicense
iosVppAppAssignedLicense
iosVppAppAssignedUserLicense
managedDeviceMobileAppConfigurationState
userPFXCertificate
vppTokenLicenseSummary
Addition beta Added new complex types:
iosVppAppRevokeLicensesActionResult
Addition beta Added new enum types:
androidDeviceOwnerSystemUpdateInstallType
androidDeviceOwnerWiFiSecurityType
userPfxIntendedPurpose
userPfxPaddingScheme
Addition beta Added the createGooglePlayWebToken action on androidManagedStoreAccountEnterpriseSettings
Addition beta Added the revokeAllLicenses action on iosVppApp
Addition beta Added the revokeUserLicense action on iosVppApp
Addition beta Added the revokeDeviceLicense action on iosVppApp
Addition beta Added the sendCustomNotificationToCompanyPortal action on deviceManagement
Addition beta Added the getLicensesForApp function on vppToken collection
Deletion beta Removed the following enum types:
windowsUpdateInsiderBuildControl
Addition beta Added the systemUpdateWindowStartMinutesAfterMidnight, systemUpdateWindowEndMinutesAfterMidnight and systemUpdateInstallType properties to the androidDeviceOwnerGeneralDeviceConfiguration entity
Change beta Changed the type of the following properties on the androidDeviceOwnerGeneralDeviceConfiguration entity:
passwordMinutesOfInactivityBeforeScreenTimeout from Int64 to Int32
Addition beta Added the customKeyValueData property to the androidForWorkVpnConfiguration entity
Addition beta Added the customKeyValueData property to the androidVpnConfiguration entity
Addition beta Added the customKeyValueData property to the androidWorkProfileVpnConfiguration entity
Addition beta Added the customKeyValueData property to the appleVpnConfiguration entity
Addition beta Added the userId and userPrincipalName properties to the deviceCompliancePolicyState entity
Addition beta Added the userId and userPrincipalName properties to the deviceConfigurationState entity
Addition beta Added the connectorServerName property to the deviceManagementExchangeConnector entity
Deletion beta Removed the settingXml property from the iosMobileAppConfiguration entity
Addition beta Added the vppTokenId and revokeLicenseActionResults properties to the iosVppApp entity
Addition beta Added the firewallEnabled, firewallBlockAllIncoming and firewallEnableStealthMode properties to the macOSCompliancePolicy entity
Deletion beta Removed the remoteAssistanceSessionErrorString property from the managedDevice entity
Addition beta Added the antivirusRequired and antiSpywareRequired properties to the windows10CompliancePolicy entity
Addition beta Added the defenderOfficeAppsOtherProcessInjection, defenderOfficeAppsExecutableContentCreationOrLaunch, defenderOfficeAppsLaunchChildProcess, defenderOfficeMacroCodeAllowWin32Imports, defenderScriptObfuscatedMacroCode, defenderScriptDownloadedPayloadExecution, defenderProcessCreation, defenderUntrustedUSBProcess, defenderUntrustedExecutable and defenderEmailContentExecution properties to the windows10EndpointProtectionConfiguration entity
Addition beta Added the searchDisableLocation, inkWorkspaceAccessState, defenderPotentiallyUnwantedAppActionSetting and defenderCloudExtendedTimeoutInSeconds properties to the windows10GeneralConfiguration entity
Addition beta Added the updatesMinimumAutoInstallClassification property to the windows81GeneralConfiguration entity
Deletion beta Removed the previewBuildSetting property from the windowsUpdateForBusinessConfiguration entity
Addition beta Added the userPfxCertificates navigation property to the deviceManagement entity
Addition beta Added the assignedLicenses navigation property to the iosVppApp entity
Addition beta Added the managedDeviceMobileAppConfigurationStates navigation property to the managedDevice entity
Addition beta Added the websiteList property to the iosWebContentFilterSpecificWebsitesAccess complex type
Addition beta Added the androidWorkProfile member to the devicePlatformType enum type
Addition beta Added the notConfigured member to the editionUpgradeLicenseType enum type
Addition beta Added the unknown member to the iosUpdatesInstallStatus enum type
Addition beta Added the userRequestedInstall member to the mobileAppActionType enum type
Addition beta Added the notConfigured member to the windows10EditionType enum type

Microsoft Teams APIs

Change type Version Description
Addition Beta Added team archive and unarchive APIs.
Addition Beta Added team clone operation.
Addition Beta Added APIs to add and remove apps to teams.
Change Beta Updated the path to the team entity.
Change Beta Updated the path to the channel entity.

Privileged Identity Management APIs

Change type Version Description
Addition beta Added the privilegedAccess entity.
Addition beta Added the governanceResource entity, and the following methods and actions:
List
Get
Addition beta Added the governanceSubject entity.
Addition beta Added the governanceRoleDefinition entity, and tollowing methods and actions:
List
Get
Addition beta Added the governanceRoleAssignment entity, and following methods and actions:
List
Get
Export
Addition beta Added the governanceRoleAssignmentRequest entity, and following methods and actions:
List
Get
Create
Cancel
Update
Addition beta Added the governanceRoleSetting entity, and the following methods and actions:
List
Get
Update
Addition beta Added the following complex types:
governancePermission
governanceRoleAssignmentRequestStatus
governanceRuleSetting
governanceSchedule

Security APIs

Change type Version Description
Addition beta Added new enum types:
alertFeedback
alertStatus
alertType
applicationPermissionsRequired
logonType
processIntegrityLevel
securityNetworkProtocol
userAccountSecurityType

May 2018

Directory APIs

Change type Version Description
Addition v1.0 Added List deleted items owned by a user action to directory (deleted items) resource
Addition beta Added the getUserOwnedObjects function to the directory resource to list the deleted groups owned by a given user.

Education API

Change type Version Description
Change v1.0 and beta The scope Members.Read.Hidden is required to read or update the Members collection on an educationClass entity using app-only tokens.
Change Beta Updated the possible values of educationSubmissionStatus type in the status property of educationsubmission.
Change Beta Added the educationAssignmentIndividualRecipient complex type to the assignTo property of educationAssignment.
Change Beta Added the unsubmittedBy, unsubmittedDate, returnedBy, returnedDate property of educationSubmission.
Addition Beta Added the return and unsubmit action to educationSubmission.
Change Beta Removed the release and recall action on educationSubmission.

Groups

Change type Version Description
Addition v1.0 and beta Added the importance property to the post entity.

Microsoft Bookings API

Change type Version Description
Addition Beta Added the bookingBusiness entity and the following CRUD methods and actions:
List
Create
Get
Update
Delete
Publish
Unpublish.
Find out more about integrating with the Microsoft Bookings API.
Addition Beta Added the bookingAppointment entity and the following CRUD methods and action:
List
Create
Get
Update
Delete
Cancel.
Addition Beta Added the bookingCurrency entity and the following methods:
List
Get.
Addition Beta Added the bookingCustomer entity and the following CRUD methods:
List
Create
Get
Update
Delete.
Addition Beta Added the bookingService entity and the following CRUD methods:
List
Create
Get
Update
Delete.
Addition Beta Added the bookingStaffMember entity and the following CRUD methods:
List
Create
Get
Update
Delete.
Addition Beta Added the following complex types:
bookingNamedEntity
bookingPerson
bookingReminder
bookingWorkHours
bookingWorkTimeSlot.

Microsoft Intune APIs

Change type Version Description
Addition beta Added new entities:
androidWorkProfileCompliancePolicy
easEmailProfileConfigurationBase
mobileAppIntentAndState
mobileAppTroubleshootingEvent
unsupportedDeviceConfiguration
windowsKioskConfiguration
Addition beta Added new complex types:
managedDeviceCleanupSettings
mobileAppIntentAndStateDetail
mobileAppTroubleshootingAppPolicyCreationHistory
mobileAppTroubleshootingAppStateHistory
mobileAppTroubleshootingAppTargetHistory
mobileAppTroubleshootingAppUpdateHistory
mobileAppTroubleshootingDeviceCheckinHistory
mobileAppTroubleshootingHistoryItem
unsupportedDeviceConfigurationDetail
windowsAutoPilotEnrollmentSettings
windowsKioskActiveDirectoryGroup
windowsKioskAppBase
windowsKioskAppConfiguration
windowsKioskAutologon
windowsKioskAzureADGroup
windowsKioskAzureADUser
windowsKioskDesktopApp
windowsKioskLocalGroup
windowsKioskLocalUser
windowsKioskMultipleApps
windowsKioskProfile
windowsKioskSingleUWPApp
windowsKioskUser
windowsKioskUWPApp
windowsKioskVisitor
Addition beta Added new enum types:
defenderScheduleScanDay
defenderSubmitSamplesConsentType
domainNameSource
localSecurityOptionsSmartCardRemovalBehaviorType
mobileAppActionType
mobileAppIntent
roleAssignmentScopeType
usernameSource
windowsDeviceUsageType
Addition beta Added the setDeviceName
action on managedDevice
Deletion beta Removed the following entities:
depEnrollmentProfile
enrollmentProfile
importedAppleDeviceIdentity
importedAppleDeviceIdentityResult
Deletion beta Removed the following complex types:
managementCertificateWithThumbprint
Deletion beta Removed the following enum types:
depTokenType
discoverySource
iTunesPairingMode
Deletion beta Removed the importAppleDeviceIdentityList action on importedAppleDeviceIdentity collection
Deletion beta Removed the updateDeviceProfileAssignment action on enrollmentProfile
Deletion beta Removed the setDefaultProfile action on enrollmentProfile
Deletion beta Removed the shareForSchoolDataSyncService action on depOnboardingSetting
Deletion beta Removed the unshareForSchoolDataSyncService action on depOnboardingSetting
Deletion beta Removed the exportMobileConfig](/graph/api/intune_corpenrollment_enrollmentprofile_exportmobileconfig?view=graph-rest-beta) function on enrollmentProfile
Addition beta Added the userDomainNameSource and customDomainName properties to the androidEasEmailProfileConfiguration entity
Addition beta Added the workProfileBlockCamera and workProfileBlockCrossProfileContactsSearch properties to the androidForWorkGeneralDeviceConfiguration entity
Addition beta Added the workProfileBlockCamera and workProfileBlockCrossProfileContactsSearch properties to the androidWorkProfileGeneralDeviceConfiguration entity
Addition beta Added the thirdPartyKeyboardsBlocked and filterOpenInToOnlyManagedApps properties to the defaultManagedAppProtection entity
Addition beta Added the conflictCount property to the deviceComplianceUserOverview entity
Addition beta Added the conflictCount property to the deviceConfigurationUserOverview entity
Addition beta Added the managedDeviceCleanupSettings property to the deviceManagement entity
Deletion beta Removed the usernameSource property from the iosEasEmailProfileConfiguration entity
Addition beta Added the thirdPartyKeyboardsBlocked and filterOpenInToOnlyManagedApps properties to the iosManagedAppProtection entity
Addition beta Added the ignoreVersionDetection property to the macOSLobApp entity
Addition beta Added the pinRequiredOnLaunchInsteadOfBiometric and pinRequiredInsteadOfBiometricTimeout properties to the managedAppProtection entity
Addition beta Added the autopilotEnrolled, requireUserEnrollmentApproval, iccid and udid properties to the managedDevice entity
Deletion beta Removed the isAutopilotEnrolled property from the managedDevice entity
Addition beta Added the notApplicablePlatformCount and conflictCount properties to the managedDeviceMobileAppConfigurationDeviceSummary entity
Addition beta Added the conflictCount property to the managedDeviceMobileAppConfigurationUserSummary entity
Addition beta Added the scopeType property to the roleAssignment entity
Deletion beta Removed the usernameSource property from the windows10EasEmailProfileConfiguration entity
Addition beta Added the localSecurityOptionsDisableClientDigitallySignCommunicationsIfServerAgrees, localSecurityOptionsClientSendUnencryptedPasswordToThirdPartySMBServers, localSecurityOptionsDisableServerDigitallySignCommunicationsAlways, localSecurityOptionsDisableServerDigitallySignCommunicationsIfClientAgrees, localSecurityOptionsRestrictAnonymousAccessToNamedPipesAndShares, localSecurityOptionsDoNotAllowAnonymousEnumerationOfSAMAccounts, localSecurityOptionsAllowAnonymousEnumerationOfSAMAccountsAndShares, localSecurityOptionsDoNotStoreLANManagerHashValueOnNextPasswordChange and localSecurityOptionsSmartCardRemovalBehavior properties to the windows10EndpointProtectionConfiguration entity
Addition beta Added the showInstallationProgress, blockDeviceSetupRetryByUser, allowDeviceResetOnInstallFailure, allowLogCollectionOnInstallFailure, customErrorMessage, installProgressTimeoutInMinutes and allowDeviceUseOnInstallFailure properties to the windows10EnrollmentCompletionPageConfiguration entity
Deletion beta Removed the title, bodyText, moreInfoUrl and moreInfoText properties from the windows10EnrollmentCompletionPageConfiguration entity
Addition beta Added the defenderBlockOnAccessProtection, defenderScheduleScanDay and defenderSubmitSamplesConsentType properties to the windows10GeneralConfiguration entity
Addition beta Added the language and enrollmentSettings properties to the windowsAutopilotDeploymentProfile entity
Addition beta Added the useDeviceContext property to the windowsMobileMSI entity
Deletion beta Removed the usernameSource property from the windowsPhoneEASEmailProfileConfiguration entity
Deletion beta Removed the localActions navigation property from the androidCompliancePolicy entity
Deletion beta Removed the enrollmentProfiles and importedAppleDeviceIdentities navigation properties from the deviceManagement entity
Addition beta Added the mobileAppIntentAndStates and mobileAppTroubleshootingEvents navigation properties to the user entity
Addition beta Added the deviceUsageType and skipKeyboardSelectionPage properties to the outOfBoxExperienceSettings complex type
Deletion beta Removed the paloAltoGlobalProtect member from the androidForWorkVpnConnectionType enum type
Addition beta Added the samAccountName and primarySmtpAddress members to the androidUsernameSource enum type
Deletion beta Removed the paloAltoGlobalProtect member from the androidVpnConnectionType enum type
Addition beta Added the paloAltoGlobalProtect member to the windows10VpnConnectionType enum type

Insights API

Change type Version Description
Addition Beta Added the settings entity and the following CRUD methods:
Get
Update

Azure AD APIs

Change type Version Description
Change Beta Renamed the creatorUserId property of the subscription entity to creatorId to better reflect its meaning.

April 2018

Audit log API

Change type Version Description
Addition Beta Added the directoryAudit and signIn entities to support a new audit log API.
Addition Beta Added the following resources to support the audit log API: appIndentity, auditActivityInitiator, conditionalAccessPolicy, deviceDetail, mfaDetail, modifiedProperty, signinLocation, signinStatus, targetResource, targetResourceApp, targetResourceDevice, targetResourceDirectory, targetResourceGroup, targetResourceOther, targetResourcePolicy, targetResourceRole, targetResourceServicePrincipal, targetResourceUser, userIdentity

Directory APIs

Change type Version Description
Addition v1.0 Added the privacyProfile complex type to the organization entity.
Addition v1.0 Added the legalAgeGroup, ageGroup and consentProvidedForMinor complex type to the user entity.
Addition v1.0 Added users and groups support to webhook notification subscriptions.
Addition beta Added List deleted items owned by a user action to directory (deleted items) resource

Education APIs

Change type Version Description
Change Beta Added the reportableIdentifier property to educationsynchronizationerror.
Change Beta Updated the response options for the uploadUrl API.
Change Beta Updated the text for description of the educationSynchronizationError resource type.
Change Beta Updated the text for description of the get sync errors API.

Microsoft Intune APIs

Change type Version Description
Addition v1.0 Added new entities:
managedDeviceMobileAppConfigurationDeviceStatus
Addition v1.0 Added new enum types:
managedDeviceOwnerType
Addition v1.0 Added the managedDeviceOwnerType property to the managedDevice entity
Addition v1.0 Added the deviceStatuses navigation property to the managedDeviceMobileAppConfiguration entity
Addition v1.0 Added the androidWorkProfile member to the policyPlatformType enum type
Addition beta Added new entities:
androidWorkProfileCertificateProfileBase
androidWorkProfileCustomConfiguration
androidWorkProfileEasEmailProfileBase
androidWorkProfileEnterpriseWiFiConfiguration
androidWorkProfileGeneralDeviceConfiguration
androidWorkProfileGmailEasConfiguration
androidWorkProfileNineWorkEasConfiguration
androidWorkProfilePkcsCertificateProfile
androidWorkProfileScepCertificateProfile
androidWorkProfileTrustedRootCertificate
androidWorkProfileVpnConfiguration
androidWorkProfileWiFiConfiguration
restrictedAppsViolation
windowsAutopilotDeploymentProfileAssignment
Addition beta Added new complex types:
managedDeviceModelsAndManufacturers
managedDeviceReportedApp
windowsEnrollmentStatusScreenSettings
Addition beta Added new enum types:
androidWorkProfileCrossProfileDataSharingType
androidWorkProfileDefaultAppPermissionPolicyType
androidWorkProfileRequiredPasswordType
androidWorkProfileVpnConnectionType
bitLockerRecoveryInformationType
localSecurityOptionsInformationShownOnLockScreenType
managedAppRemediationAction
managedDeviceOwnerType
restrictedAppsState
windows10VpnProfileTarget
Addition beta Added the playLostModeSound action on managedDevice
Deletion beta Removed the following enum types:
bitLockerRecoveryinformationType
windowsUpdateRestartMode
Addition beta Added the workProfileBlockScreenCapture and workProfileBlockCrossProfileCallerId properties to the androidForWorkGeneralDeviceConfiguration entity
Addition beta Added the minimumWipePatchVersion, allowedAndroidDeviceManufacturers and appActionIfAndroidDeviceManufacturerNotAllowed properties to the androidManagedAppProtection entity
Addition beta Added the minimumWipeSdkVersion, minimumWipePatchVersion, allowedIosDeviceModels, appActionIfIosDeviceModelNotAllowed, allowedAndroidDeviceManufacturers and appActionIfAndroidDeviceManufacturerNotAllowed properties to the defaultManagedAppProtection entity
Addition beta Added the notApplicablePlatformCount and conflictCount properties to the deviceComplianceDeviceOverview entity
Addition beta Added the notApplicablePlatformCount and conflictCount properties to the deviceConfigurationDeviceOverview entity
Addition beta Added the accountMoveCompletionDateTime property to the deviceManagement entity
Addition beta Added the minimumWipeSdkVersion, allowedIosDeviceModels and appActionIfIosDeviceModelNotAllowed properties to the iosManagedAppProtection entity
Addition beta Added the minimumWipeOsVersion, minimumWipeAppVersion, appActionIfDeviceComplianceRequired and appActionIfMaximumPinRetriesExceeded properties to the managedAppProtection entity
Addition beta Added the managedDeviceOwnerType, preferMdmOverGroupPolicyAppliedDateTime, isAutopilotEnrolled and requestUserEnrollmentApproval properties to the managedDevice entity
Addition beta Added the managedDeviceModelsAndManufacturers property to the managedDeviceOverview entity
Addition beta Added the localSecurityOptionsMachineInactivityLimitInMinutes, localSecurityOptionsAllowRemoteCallsToSecurityAccountsManagerHelperBool, localSecurityOptionsInformationShownOnLockScreen, defenderSecurityCenterDisableAccountUI, defenderSecurityCenterDisableHardwareUI, defenderSecurityCenterDisableRansomwareUI, defenderSecurityCenterDisableSecureBootUI and defenderSecurityCenterDisableTroubleshootingUI properties to the windows10EndpointProtectionConfiguration entity
Addition beta Added the printerNames, printerDefaultName, printerBlockAddition and searchBlockWebResults properties to the windows10GeneralConfiguration entity
Addition beta Added the profileTarget, enableAlwaysOn and enableDeviceTunnel properties to the windows10VpnConfiguration entity
Addition beta Added the enrollmentStatusScreenSettings property to the windowsAutopilotDeploymentProfile entity
Addition beta Added the deviceConfigurationRestrictedAppsViolations navigation property to the deviceManagement entity
Addition beta Added the assignments navigation property to the windowsAutopilotDeploymentProfile entity
Addition beta Added the networkAccessConfigurations navigation property to the windowsDomainJoinConfiguration entity
Deletion beta Removed the permissions property from the auditActor complex type
Change beta Changed the type of the following properties on the bitLockerRecoveryOptions complex type:
recoveryInformationToStore from bitLockerRecoveryinformationType to bitLockerRecoveryInformationType
Addition beta Added the deviceInactivityBeforeRetirementInDay property to the deviceManagementSettings complex type
Addition beta Added the landingPageCustomizedImage property to the intuneBrand complex type
Deletion beta Removed the ipAddressOrFqdn property from the vpnServer complex type
Deletion beta Removed the restartMode property from the windowsUpdateScheduledInstall complex type
Addition beta Added the paloAltoGlobalProtect member to the androidForWorkVpnConnectionType enum type
Addition beta Added the paloAltoGlobalProtect member to the androidVpnConnectionType enum type
Addition beta Added the paloAltoGlobalProtect member to the appleVpnConnectionType enum type
Addition beta Added the androidWorkProfile member to the policyPlatformType enum type

Outlook calendar

Change type Version Description
Addition v1.0 Added the locations property to the event entity to support organizing an event that attendees can attend from more than one location.
Addition v1.0 Added the locationType property to the location complex type.
Addition v1.0 Added the uniqueId and uniqueIdType properties to the location complex type. These properties are only for internal use at this point.

Outlook contacts

Change type Version Description
Addition v1.0 Added the flag property to the contact entity. Added the shared followupFlag complex type.

Outlook mail

Change type Version Description
Addition v1.0 Added the flag property to the message entity. Added the shared followupFlag complex type.
Addition v1.0 Added the internetMessageHeaders property to the message entity.
Addition v1.0 Added the internetMessageHeader complex type.
Addition v1.0 Added the messageRules navigation property to the mailFolder entity. messageRules is a collection of messageRule instances.
Addition v1.0 Added the messageRule entity, and messageRuleActions, messageRulePredicates, and sizeRange complex types.
Addition v1.0 Added the following CRUD operations for message rules: create, list, get, update, and delete.
Addition Beta Added mailSearchFolder.
Addition Beta Added the following APIs for mail search folder: Create, Update.
Change Beta Added support for mail search folder to delete mailFolder, get mailFolder, and list child folders.

Outlook user choices

Change type Version Description
Addition v1.0 Added the new masterCategories navigation property to the outlookUser entity. masterCategories is a collection of outlookCategory objects.
Addition v1.0 Added the outlookCategory entity.
Addition v1.0 Added the following CRUD operations for outlookCategory: create, get, update, and delete.
Addition v1.0 Added the new supportedLanguages function to the outlookUser entity.
Addition v1.0 Added the new supportedTimeZones function to the outlookUser entity.
Addition v1.0 Added the new workingHours property to mailboxSettings. See workingHours resource type for information on the supported use cases.
Addition v1.0 Added the following new complex types:
workingHours
timeZoneBase
customTimeZone
standardTimeZoneOffset
daylightTimeZoneOffset

Microsoft Teams

Change type Version Description
Addition Beta Added new teamMemberSettings entity.
Addition Beta Added new teamGuestSettings entity.
Addition Beta Added new teamMessagingSettings entity.
Addition Beta Added new teamFunSettings entity.
Addition Beta Added new delete channel operation.
Addition Beta Added new patch channel operation.
Addition Beta Added new webUrl property to team resource.
Change Beta Updated the path to the channel entity.

Project Rome APIs

Change type Version Description
Addition v1.0 Added Get recent activities API
Addition v1.0 Added Get activities API
Addition v1.0 Added Upsert Activity
Addition v1.0 Added Upsert HistoryItem
Addition v1.0 Added Delete Activity
Addition v1.0 Added Upsert HistoryItem
Addition v1.0 Added activity
Addition v.10 Added historyItem
Addition v1.0 Added visualInfo
Addition v1.0 Added imageInfo
Addition v.10 Added Project Rome overview
Change Beta Added deep insert documentation to Upsert Activity

Reports APIs

Change type Version Description
Addition beta Added delegated access support.
Addition v1.0 Added delegated access support.

Security APIs

Change type Version Description
Addition Beta Added the security API, including the following resources and operations:
alert (and related entities)
Get alert
List alerts
Update alert

Added the following supporting documentation:
Errors
Integrate with a SIEM

March 2018

Data Policy Operations

Change type Version Description
Addition beta Added new entity dataPolicyOperation. This represents a submitted data policy operation for tracking purposes.
Addition beta Added the exportPersonalData action on users. This action submits a data policy operation request to export personal data stored by Microsoft for a user.

ActivityFeedService APIs

Change type Version Description
Addition Beta Added Get recent activities API
Addition Beta Added Get activities API
Change Beta Added UserActivity.ReadWrite.CreatedByApp permission to Upsert Activity
Change Beta Added UserActivity.ReadWrite.CreatedByApp permission to Upsert HistoryItem
Change Beta Added UserActivity.ReadWrite.CreatedByApp permission to Delete Activity
Change Beta Added UserActivity.ReadWrite.CreatedByApp permission to Upsert HistoryItem
Change Beta Added status property to activity
Change Beta Added activity navigation property to historyItem
Change Beta Added new APIs to Project Rome overview

Azure AD APIs

Change type Version Description
Change beta Added the applicationID and creatorUserID properties to the subscription resource.
Change beta Added the list operation to the subscription entity.

Directory APIs

Change type Version Description
Addition Beta Added the onPremisesExtensionAttributes complex type to the user entity. This contains the on-premises AD extension attributes 1-15.
Addition Beta Added the privacyProfile complex type to the organization entity.
Addition v1.0 Added support for restoring and permanently deleting users and groups.

Excel APIs

Change type Version Description
Change v1.0 Added the legacyId property to the Excel Table entity. This will contain the numeric value identifier (string data type) that will remain constact for a given Excel table. This is provided as an additional metadata if the application relied on the legacy identifier used in older Excel client applications. Note: The id and legacyId property should be treated as an opaque string value and should not be parsed to any other type within your application.

Reports APIs

Change type Version Description
Addition beta Added the siteId property to the sharePointSiteUsageDetail entity.

Group lifecycle policy

Change type Version Description
Addition v1.0 Added groupLifecyclePolicy
Addition v1.0 Added the following APIs for group lifecycle policy: Create, List, Get, Update, Delete, Add group, Remove group
Addition v1.0 Added List groupLifecyclePolicies function to group
Change v1.0 Added renewedDateTime property and renew to group

Terms of use

Change type Version Description
Addition Beta Added the agreement and agreementAcceptance resources.
Addition Beta Added the following APIs for agreement: Create, List, Get, Update, Delete.
Addition Beta Added the agreementAcceptance relationships to the user resource.

Microsoft Intune APIs

Change type Version Description
Addition v1.0 Added new entities:
iosMobileAppConfiguration
vppToken
Addition v1.0 Added new complex types:
appConfigurationSettingItem
Addition v1.0 Added the syncLicenses action on vppToken
Addition v1.0 Added the vppTokens navigation property to the deviceAppManagement entity
Addition beta Added the managementCertificateExpirationDate property to the managedDevice entity
Addition beta Added the enhancedJailBreak property to the deviceManagementSettings complex type
Addition beta Added new entities:
androidDeviceOwnerEnrollmentProfile
androidDeviceOwnerGeneralDeviceConfiguration
androidManagedStoreAccountEnterpriseSettings
androidManagedStoreAppConfigurationSchema
dataSharingConsent
deviceConfigurationUserStateSummary
macOSEndpointProtectionConfiguration
macOSImportedPFXCertificateProfile
macOSLobApp
managedEBookCategory
microsoftStoreForBusinessContainedApp
mobileContainedApp
windowsUniversalAppXContainedApp
Addition beta Added new complex types:
androidManagedStoreAppConfigurationSchemaItem
deviceAndAppManagementData
loggedOnUser
macOSFirewallApplication
macOSLobChildApp
macOSMinimumOperatingSystem
windowsAppXAppAssignmentSettings
windowsUniversalAppXAppAssignmentSettings
Addition beta Added the requestSignupUrl action on androidManagedStoreAccountEnterpriseSettings
Addition beta Added the completeSignup action on androidManagedStoreAccountEnterpriseSettings
Addition beta Added the syncApps action on androidManagedStoreAccountEnterpriseSettings
Addition beta Added the unbind action on androidManagedStoreAccountEnterpriseSettings
Addition beta Added the revokeToken action on androidDeviceOwnerEnrollmentProfile
Addition beta Added the createToken action on androidDeviceOwnerEnrollmentProfile
Addition beta Added the assign action on managedDeviceMobileAppConfiguration
Addition beta Added the consentToDataSharing action on dataSharingConsent
Addition beta Added the getLoggedOnManagedDevices function on user
Addition beta Added the exportDeviceAndAppManagementData function on user
Addition beta Added the exportDeviceAndAppManagementData function on user
Deletion beta Removed the following entities:
appleVolumePurchaseProgramToken
mdmAppConfigGroupAssignment
windows10KioskConfiguration
Deletion beta Removed the assign action on managedDeviceMobileAppConfiguration
Deletion beta Removed the syncApps action on appleVolumePurchaseProgramToken
Addition beta Added the workProfileBluetoothEnableContactSharing property to the androidForWorkGeneralDeviceConfiguration entity
Addition beta Added the intendedPurpose property to the androidForWorkImportedPFXCertificateProfile entity
Addition beta Added the intendedPurpose property to the androidImportedPFXCertificateProfile entity
Addition beta Added the intendedPurpose property to the iosImportedPFXCertificateProfile entity
Addition beta Added the encodedSettingXml property to the iosMobileAppConfiguration entity
Addition beta Added the managedDeviceId and azureADDeviceId properties to the managedAppRegistration entity
Addition beta Added the usersLoggedOn property to the managedDevice entity
Deletion beta Removed the lastLoggedOnUserId property from the managedDevice entity
Addition beta Added the lastModifiedDateTime property to the managedDeviceOverview entity
Addition beta Added the isDependency property to the mobileAppContentFile entity
Addition beta Added the windowsEnabled, macEnabled, windowsDeviceBlockedOnMissingPartnerData and macDeviceBlockedOnMissingPartnerData properties to the mobileThreatDefenseConnector entity
Addition beta Added the shouldUninstallOlderVersionsOfOffice property to the officeSuiteApp entity
Addition beta Added the dataSharingConsentGranted property to the vppToken entity
Addition beta Added the localSecurityOptionsBlockRemoteLogonWithBlankPassword, localSecurityOptionsAdministratorAccountName, localSecurityOptionsEnableGuestAccount, localSecurityOptionsGuestAccountName, localSecurityOptionsAllowUndockWithoutHavingToLogon, localSecurityOptionsBlockUsersInstallingPrinterDrivers, localSecurityOptionsBlockRemoteOpticalDriveAccess, localSecurityOptionsFormatAndEjectOfRemovableMediaAllowedUser, localSecurityOptionsMachineInactivityLimit, localSecurityOptionsDoNotRequireCtrlAltDel, localSecurityOptionsInformationDisplayedOnLockScreen, localSecurityOptionsHideLastSignedInUser, localSecurityOptionsHideUsernameAtSignIn, localSecurityOptionsLogOnMessageTitle, localSecurityOptionsLogOnMessageText, localSecurityOptionsAllowPKU2UAuthenticationRequests, localSecurityOptionsAllowRemoteCallsToSecurityAccountsManager, localSecurityOptionsClearVirtualMemoryPageFile, localSecurityOptionsAllowSystemToBeShutDownWithoutHavingToLogOn, localSecurityOptionsAllowUIAccessApplicationElevation, localSecurityOptionsVirtualizeFileAndRegistryWriteFailuresToPerUserLocations, localSecurityOptionsOnlyElevateSignedExecutables, localSecurityOptionsAdministratorElevationPromptBehavior, localSecurityOptionsStandardUserElevationPromptBehavior, localSecurityOptionsSwitchToSecureDesktopWhenPromptingForElevation, localSecurityOptionsDetectApplicationInstallationsAndPromptForElevation, localSecurityOptionsAllowUIAccessApplicationsForSecureLocations, localSecurityOptionsUseAdminApprovalMode, localSecurityOptionsUseAdminApprovalModeForAdministrators, deviceGuardLocalSystemAuthorityCredentialGuardSettings, deviceGuardEnableVirtualizationBasedSecurity and deviceGuardEnableSecureBootWithDMA properties to the windows10EndpointProtectionConfiguration entity
Deletion beta Removed the defenderPasswordProtectedEmailContentExecutionType property from the windows10EndpointProtectionConfiguration entity
Addition beta Added the intendedPurpose property to the windows10ImportedPFXCertificateProfile entity
Deletion beta Removed the printerNames, defaultPrinterName and blockAddingNewPrinter properties from the windows10SecureAssessmentConfiguration entity
Addition beta Added the certificateStore property to the windows81SCEPCertificateProfile entity
Addition beta Added the purchaseOrderIdentifier property to the windowsAutopilotDeviceIdentity entity
Change beta Changed the following properties on the windowsCertificateProfileBase entity:
subjectAlternativeNameType from required to optional
Addition beta Added the advancedThreatProtectionOnboardingFilename and advancedThreatProtectionOffboardingFilename properties to the windowsDefenderAdvancedThreatProtectionConfiguration entity
Addition beta Added the intendedPurpose property to the windowsPhone81ImportedPFXCertificateProfile entity
Addition beta Added the skipChecksBeforeRestart and updateWeeks properties to the windowsUpdateForBusinessConfiguration entity
Addition beta Added the managedEBookCategories navigation property to the deviceAppManagement entity
Addition beta Added the androidManagedStoreAccountEnterpriseSettings, androidManagedStoreAppConfigurationSchemas, androidDeviceOwnerEnrollmentProfiles, dataSharingConsents and deviceConfigurationUserStateSummaries navigation properties to the deviceManagement entity
Deletion beta Removed the deviceSetupConfigurations navigation property from the deviceManagement entity
Deletion beta Removed the groupAssignments navigation property from the managedDeviceMobileAppConfiguration entity
Addition beta Added the categories navigation property to the managedEBook entity
Addition beta Added the containedApps navigation property to the microsoftStoreForBusinessApp entity
Addition beta Added the containedApps navigation property to the mobileAppContent entity
Addition beta Added the committedContainedApps navigation property to the windowsUniversalAppX entity

OneDrive

Change type Version Description
Addition v1.0 Added new entities:
baseItemVersion
driveItemVersion
listItemVersion
Addition v1.0 Added new complex types:
publicationFacet
Addition v1.0 Added the publication property to the driveItem entity
Addition v1.0 Added the versions navigation property to the driveItem entity
Addition v1.0 Added the versions navigation property to the listItem entity
Addition v1.0 Added the root property to the siteCollection entity
Addition v1.0 Added the restoreVersion action for the driveItemVersion entity
Addition v1.0 Added the restoreVersion action for the listItemVersion entity

OneDrive

Change type Version Description
Addition beta Added new complex type:
itemPreviewInfo
Addition beta Added the name property to the contentTypeInfo complex type
Addition beta Added the objectType property to the deleteAction complex type
Addition beta Added the newName property to the renameAction complex type
Addition beta Added the tenantId property to the sharepointIds complex type
Addition beta Added the lastRecordedDateTime property to the itemActivityTimeSet complex type
Addition beta Added the preview action for the driveItem entity

February 2018

Microsoft Intune APIs

Change type Version Description
Addition beta Added new entities:
androidForWorkImportedPFXCertificateProfile
androidImportedPFXCertificateProfile
importedWindowsAutopilotDeviceIdentity
iosImportedPFXCertificateProfile
windows10ImportedPFXCertificateProfile
windows10KioskConfiguration
windowsPhone81ImportedPFXCertificateProfile
Addition beta Added new complex types:
importedWindowsAutopilotDeviceIdentityState
Addition beta Added the managedDeviceEnrollmentFailureDetails function on reportRoot
Addition beta Added the managedDeviceEnrollmentFailureDetails function on reportRoot
Addition beta Added the managedDeviceEnrollmentFailureTrends function on reportRoot
Addition beta Added the managedDeviceEnrollmentTopFailures function on reportRoot
Addition beta Added the managedDeviceEnrollmentTopFailures function on reportRoot
Change beta Removed the requireAppVerify, requireSafetyNetAttestationBasicIntegrity, requireSafetyNetAttestationCertifiedDevice, requireGooglePlayServices, requireUpToDateSecurityProviders and requireCompanyPortalAppIntegrity properties from the androidCompliancePolicy entity
Change beta Removed the requireAppVerify, requireSafetyNetAttestationBasicIntegrity, requireSafetyNetAttestationCertifiedDevice, requireGooglePlayServices, requireUpToDateSecurityProviders and requireCompanyPortalAppIntegrity properties from the androidForWorkCompliancePolicy entity
Change beta Removed the name, modifiedDateTime, totalEnrollmentCount and qrCode properties from the androidForWorkEnrollmentProfile entity
Change beta Removed the nonEapAuthenticationMethodForEapTtls, nonEapAuthenticationMethodForPeap and enableOuterIdentityPrivacy properties from the androidForWorkEnterpriseWiFiConfiguration entity
Change beta Added the workProfileBlockAddingAccounts property to the androidForWorkGeneralDeviceConfiguration entity
Change beta Removed the blockCrossProfileCopyPaste and requireAppVerify properties from the androidForWorkGeneralDeviceConfiguration entity
Change beta Added the deviceOwnerManagementEnabled property to the androidForWorkSettings entity
Change beta Removed the requireAppVerify property from the androidGeneralDeviceConfiguration entity
Change beta Added the exemptedAppPackages property to the androidManagedAppProtection entity
Change beta Added the exemptedAppProtocols and exemptedAppPackages properties to the defaultManagedAppProtection entity
Change beta Added the exemptedAppProtocols property to the iosManagedAppProtection entity
Change beta Added the lastLoggedOnUserId property to the managedDevice entity
Change beta Added the isFrameworkFile property to the mobileAppContentFile entity
Change beta Added the targetedAppManagementLevels property to the targetedManagedAppProtection entity
Change beta Added the localSecurityOptionsBlockMicrosoftAccounts, localSecurityOptionsEnableAdministratorAccount, defenderPreventCredentialStealingType, defenderProcessCreationType, defenderUntrustedUSBProcessType, defenderUntrustedExecutableType, defenderPasswordProtectedEmailContentExecutionType, defenderAdvancedRansomewareProtectionType and applicationGuardAllowFileSaveOnHost properties to the windows10EndpointProtectionConfiguration entity
Change beta Added the edgeFavoritesListLocation and edgeBlockEditFavorites properties to the windows10GeneralConfiguration entity
Change beta Added the printerNames, defaultPrinterName and blockAddingNewPrinter properties to the windows10SecureAssessmentConfiguration entity
Change beta Added the importedWindowsAutopilotDeviceIdentities navigation property to the deviceManagement entity
Change beta Added the shareAPNSData property to the adminConsent complex type
Change beta Removed the collectFullIOSAppInventory property from the adminConsent complex type
Change beta Removed the deviceUsageType property from the outOfBoxExperienceSettings complex type

Planner APIs

Change type Version Description
Addition Beta Added new complex types:
plannerPlanContext
plannerPlanContextDetails
plannerPlanContextCollection
plannerPlanContextDetailsCollection
plannerFavoritePlanReference
plannerRecentPlanReference
plannerFavoritePlanReferenceCollection
plannerRecentPlanReferenceCollection
Addition Beta Added favoritePlanReferences and recentPlanReferences properties to plannerUser entity.
Addition Beta Added favoritePlans and recentPlans navigation properties to plannerUser entity.
Addition Beta Added contexts property to plannerPlan entity.
Addition Beta Added contextDetails property to plannerPlanDetails entity.
Addition Beta Added Planner delta query

Reports APIs

Change type Version Description
Addition Beta Added the activatedOnSharedComputer property to the userActivationCounts entity.
Addition Beta Added the sharedComputerActivation property to the office365ActivationsUserCounts entity.

January 2018

JSON Batching

Change type Version Description
Addition v1.0 Added JSON batching support. Internal request limit set to 20.
Change Beta Increased JSON batching internal request limit from 5 to 20.

Education APIs

Change type Version Description
Addition Beta Added extra navigation properties and improve filtering support for roster API.

Microsoft Intune APIs

Change type Version Description
Addition v1.0 Added new entities:
androidCompliancePolicy
androidCustomConfiguration
androidGeneralDeviceConfiguration
androidLobApp
androidManagedAppProtection
androidManagedAppRegistration
androidStoreApp
appleDeviceFeaturesConfigurationBase
applePushNotificationCertificate
defaultManagedAppProtection
detectedApp
deviceAndAppManagementRoleAssignment
deviceAndAppManagementRoleDefinition
deviceAppManagement
deviceCategory
deviceComplianceActionItem
deviceComplianceDeviceOverview
deviceComplianceDeviceStatus
deviceCompliancePolicy
deviceCompliancePolicyAssignment
deviceCompliancePolicyDeviceStateSummary
deviceCompliancePolicySettingStateSummary
deviceCompliancePolicyState
deviceComplianceScheduledActionForRule
deviceComplianceSettingState
deviceComplianceUserOverview
deviceComplianceUserStatus
deviceConfiguration
deviceConfigurationAssignment
deviceConfigurationDeviceOverview
deviceConfigurationDeviceStateSummary
deviceConfigurationDeviceStatus
deviceConfigurationState
deviceConfigurationUserOverview
deviceConfigurationUserStatus
deviceEnrollmentConfiguration
deviceEnrollmentLimitConfiguration
deviceEnrollmentPlatformRestrictionsConfiguration
deviceEnrollmentWindowsHelloForBusinessConfiguration
deviceInstallState
deviceManagement
deviceManagementExchangeConnector
deviceManagementPartner
deviceManagementTroubleshootingEvent
eBookInstallSummary
editionUpgradeConfiguration
enrollmentConfigurationAssignment
enrollmentTroubleshootingEvent
iosCertificateProfile
iosCompliancePolicy
iosCustomConfiguration
iosDeviceFeaturesConfiguration
iosGeneralDeviceConfiguration
iosLobApp
iosManagedAppProtection
iosManagedAppRegistration
iosStoreApp
iosUpdateConfiguration
iosUpdateDeviceStatus
iosVppApp
iosVppEBook
iosVppEBookAssignment
localizedNotificationMessage
macOSCompliancePolicy
macOSCustomConfiguration
macOSDeviceFeaturesConfiguration
macOSGeneralDeviceConfiguration
macOSOfficeSuiteApp
managedAndroidLobApp
managedAndroidStoreApp
managedApp
managedAppConfiguration
managedAppOperation
managedAppPolicy
managedAppPolicyDeploymentSummary
managedAppProtection
managedAppRegistration
managedAppStatus
managedAppStatusRaw
managedDevice
managedDeviceMobileAppConfiguration
managedDeviceMobileAppConfigurationAssignment
managedDeviceMobileAppConfigurationDeviceSummary
managedDeviceMobileAppConfigurationUserStatus
managedDeviceMobileAppConfigurationUserSummary
managedDeviceOverview
managedEBook
managedEBookAssignment
managedIOSLobApp
managedIOSStoreApp
managedMobileApp
managedMobileLobApp
mdmWindowsInformationProtectionPolicy
microsoftStoreForBusinessApp
mobileApp
mobileAppAssignment
mobileAppCategory
mobileAppContent
mobileAppContentFile
mobileLobApp
mobileThreatDefenseConnector
notificationMessageTemplate
onPremisesConditionalAccessSettings
remoteAssistancePartner
resourceOperation
roleAssignment
roleDefinition
settingStateDeviceSummary
sharedPCConfiguration
softwareUpdateStatusSummary
targetedManagedAppConfiguration
targetedManagedAppPolicyAssignment
targetedManagedAppProtection
telecomExpenseManagementPartner
termsAndConditions
termsAndConditionsAcceptanceStatus
termsAndConditionsAssignment
userInstallStateSummary
webApp
windows10CompliancePolicy
windows10CustomConfiguration
windows10EndpointProtectionConfiguration
windows10EnterpriseModernAppManagementConfiguration
windows10GeneralConfiguration
windows10MobileCompliancePolicy
windows10SecureAssessmentConfiguration
windows10TeamGeneralConfiguration
windows81CompliancePolicy
windows81GeneralConfiguration
windowsDefenderAdvancedThreatProtectionConfiguration
windowsInformationProtection
windowsInformationProtectionAppLearningSummary
windowsInformationProtectionAppLockerFile
windowsInformationProtectionNetworkLearningSummary
windowsInformationProtectionPolicy
windowsMobileMSI
windowsPhone81CompliancePolicy
windowsPhone81CustomConfiguration
windowsPhone81GeneralConfiguration
windowsUniversalAppX
windowsUpdateForBusinessConfiguration
Addition v1.0 Added new complex types:
allDevicesAssignmentTarget
allLicensedUsersAssignmentTarget
androidMinimumOperatingSystem
androidMobileAppIdentifier
appListItem
bitLockerRemovableDrivePolicy
configurationManagerClientEnabledFeatures
defenderDetectedMalwareActions
deleteUserFromSharedAppleDeviceActionResult
deviceActionResult
deviceAndAppManagementAssignmentTarget
deviceCompliancePolicySettingState
deviceConfigurationSettingState
deviceEnrollmentPlatformRestriction
deviceExchangeAccessStateSummary
deviceGeoLocation
deviceHealthAttestationState
deviceManagementSettings
deviceOperatingSystemSummary
edgeSearchEngine
edgeSearchEngineBase
edgeSearchEngineCustom
exclusionGroupAssignmentTarget
fileEncryptionInfo
groupAssignmentTarget
intuneBrand
iosDeviceType
iosHomeScreenApp
iosHomeScreenFolder
iosHomeScreenFolderPage
iosHomeScreenItem
iosHomeScreenPage
iosLobAppAssignmentSettings
iosMinimumOperatingSystem
iosMobileAppIdentifier
iosNetworkUsageRule
iosNotificationSettings
iosStoreAppAssignmentSettings
iosVppAppAssignmentSettings
ipRange
iPv4Range
iPv6Range
keyValuePair
locateDeviceActionResult
managedAppDiagnosticStatus
managedAppPolicyDeploymentSummaryPerApp
mediaContentRatingAustralia
mediaContentRatingCanada
mediaContentRatingFrance
mediaContentRatingGermany
mediaContentRatingIreland
mediaContentRatingJapan
mediaContentRatingNewZealand
mediaContentRatingUnitedKingdom
mediaContentRatingUnitedStates
microsoftStoreForBusinessAppAssignmentSettings
mimeContent
mobileAppAssignmentSettings
mobileAppIdentifier
omaSetting
omaSettingBase64
omaSettingBoolean
omaSettingDateTime
omaSettingFloatingPoint
omaSettingInteger
omaSettingString
omaSettingStringXml
proxiedDomain
remoteLockActionResult
resetPasscodeActionResult
resourceAction
rgbColor
rolePermission
settingSource
sharedPCAccountManagerPolicy
updateWindowsDeviceAccountActionParameter
vppLicensingType
windows10NetworkProxyServer
windowsDefenderScanActionResult
windowsDeviceAccount
windowsDeviceADAccount
windowsDeviceAzureADAccount
windowsFirewallNetworkProfile
windowsInformationProtectionApp
windowsInformationProtectionDataRecoveryCertificate
windowsInformationProtectionDesktopApp
windowsInformationProtectionIPRangeCollection
windowsInformationProtectionProxiedDomainCollection
windowsInformationProtectionResourceCollection
windowsInformationProtectionStoreApp
windowsMinimumOperatingSystem
windowsUpdateActiveHoursInstall
windowsUpdateInstallScheduleType
windowsUpdateScheduledInstall
Addition v1.0 Added the assign action on mobileApp
Addition v1.0 Added the commit action on mobileAppContentFile
Addition v1.0 Added the renewUpload action on mobileAppContentFile
Addition v1.0 Added the retire action on managedDevice
Addition v1.0 Added the wipe action on managedDevice
Addition v1.0 Added the resetPasscode action on managedDevice
Addition v1.0 Added the remoteLock action on managedDevice
Addition v1.0 Added the requestRemoteAssistance action on managedDevice
Addition v1.0 Added the disableLostMode action on managedDevice
Addition v1.0 Added the locateDevice action on managedDevice
Addition v1.0 Added the bypassActivationLock action on managedDevice
Addition v1.0 Added the rebootNow action on managedDevice
Addition v1.0 Added the shutDown action on managedDevice
Addition v1.0 Added the recoverPasscode action on managedDevice
Addition v1.0 Added the cleanWindowsDevice action on managedDevice
Addition v1.0 Added the logoutSharedAppleDeviceActiveUser action on managedDevice
Addition v1.0 Added the deleteUserFromSharedAppleDevice action on managedDevice
Addition v1.0 Added the syncDevice action on managedDevice
Addition v1.0 Added the windowsDefenderScan action on managedDevice
Addition v1.0 Added the windowsDefenderUpdateSignatures action on managedDevice
Addition v1.0 Added the updateWindowsDeviceAccount action on managedDevice
Addition v1.0 Added the removeAllDevicesFromManagement action on user
Addition v1.0 Added the assign action on deviceConfiguration
Addition v1.0 Added the assign action on deviceCompliancePolicy
Addition v1.0 Added the scheduleActionsForRules action on deviceCompliancePolicy
Addition v1.0 Added the setMobileDeviceManagementAuthority action on organization
Addition v1.0 Added the syncMicrosoftStoreForBusinessApps action on deviceAppManagement
Addition v1.0 Added the sync action on deviceManagementExchangeConnector
Addition v1.0 Added the setPriority action on deviceEnrollmentConfiguration
Addition v1.0 Added the assign action on deviceEnrollmentConfiguration
Addition v1.0 Added the assign action on targetedManagedAppProtection
Addition v1.0 Added the assign action on targetedManagedAppConfiguration
Addition v1.0 Added the assign action on windowsInformationProtection
Addition v1.0 Added the targetApps action on managedAppPolicy
Addition v1.0 Added the targetApps action on managedAppProtection
Addition v1.0 Added the targetApps action on targetedManagedAppConfiguration
Addition v1.0 Added the wipeManagedAppRegistrationsByDeviceTag action on user
Addition v1.0 Added the sendTestMessage action on notificationMessageTemplate
Addition v1.0 Added the assign action on managedEBook
Addition v1.0 Added the beginOnboarding action on remoteAssistancePartner
Addition v1.0 Added the disconnect action on remoteAssistancePartner
Addition v1.0 Added the downloadApplePushNotificationCertificateSigningRequest function on applePushNotificationCertificate
Addition v1.0 Added the deviceConfigurationUserActivity function on reportRoot
Addition v1.0 Added the deviceConfigurationDeviceActivity function on reportRoot
Addition v1.0 Added the verifyWindowsEnrollmentAutoDiscovery function on deviceManagement
Addition v1.0 Added the getUserIdsWithFlaggedAppRegistration function on managedAppRegistration collection
Addition v1.0 Added the getManagedAppDiagnosticStatuses function on user
Addition v1.0 Added the getManagedAppPolicies function on user
Addition v1.0 Added the getEffectivePermissions function on deviceManagement
Change v1.0 Added the mobileDeviceManagementAuthority property to the organization entity
Change v1.0 Added the deviceEnrollmentLimit property to the user entity
Change v1.0 Added the managedDevices, managedAppRegistrations and deviceManagementTroubleshootingEvents navigation properties to the user entity
Addition Beta Added new entities:
deviceManagementScriptAssignment
iosCertificateProfile
windowsInformationProtectionNetworkLearningSummary
Addition Beta Added new complex types:
revokeAppleVppLicensesActionResult
vppTokenRevokeLicensesActionResult
Addition Beta Added the revokeToken action on androidForWorkEnrollmentProfile
Addition Beta Added the assign action on mobileApp
Addition Beta Added the assign action on deviceManagementScript
Addition Beta Added the revokeAppleVppLicenses action on managedDevice
Addition Beta Added the assign action on deviceCompliancePolicy
Addition Beta Added the revokeLicenses action on vppToken
Addition Beta Added the wipeManagedAppRegistrationsByDeviceTag action on user
Addition Beta Added the assign action on managedEBook
Addition Beta Added the getEffectiveDeviceEnrollmentConfigurations function on user
Deletion Beta Removed the following entities:
appReportingOverviewStatus
complianceSettingStateSummary
deviceConfigurationUserStateSummary
eBookGroupAssignment
eBookVppGroupAssignment
mobileAppGroupAssignment
mobileAppVppGroupAssignment
Deletion Beta Removed the following complex types:
androidForWorkAppConfigurationExample
androidForWorkAppConfigurationExampleJson
appInstallationFailure
appsComplianceListItem
defaultDeviceEnrollmentRestrictions
defaultDeviceEnrollmentWindowsHelloForBusinessSettings
deviceEnrollmentPlatformRestrictions
Change Beta Added the securityRequireVerifyApps, securityRequireSafetyNetAttestationBasicIntegrity, securityRequireSafetyNetAttestationCertifiedDevice, securityRequireGooglePlayServices, securityRequireUpToDateSecurityProviders and securityRequireCompanyPortalAppIntegrity properties to the androidCompliancePolicy entity
Change Beta Added the packageId property to the androidForWorkApp entity
Change Beta Changed the type of the following properties on the androidForWorkAppConfigurationSchema entity:
exampleJson from androidForWorkAppConfigurationExample to Binary
Change Beta Added the securityRequireVerifyApps, securityRequireSafetyNetAttestationBasicIntegrity, securityRequireSafetyNetAttestationCertifiedDevice, securityRequireGooglePlayServices, securityRequireUpToDateSecurityProviders and securityRequireCompanyPortalAppIntegrity properties to the androidForWorkCompliancePolicy entity
Change Beta Added the displayName, lastModifiedDateTime, enrolledDeviceCount, qrCodeContent and qrCodeImage properties to the androidForWorkEnrollmentProfile entity
Change Beta Removed the isTokenActive property from the androidForWorkEnrollmentProfile entity
Change Beta Added the innerAuthenticationProtocolForEapTtls, innerAuthenticationProtocolForPeap and outerIdentityPrivacyTemporaryValue properties to the androidForWorkEnterpriseWiFiConfiguration entity
Change Beta Added the workProfileBlockCrossProfileCopyPaste and securityRequireVerifyApps properties to the androidForWorkGeneralDeviceConfiguration entity
Change Beta Added the securityRequireVerifyApps property to the androidGeneralDeviceConfiguration entity
Change Beta Added the packageId and identityVersion properties to the androidLobApp entity
Change Beta Added the packageId property to the androidStoreApp entity
Change Beta Added the faceIdBlocked property to the defaultManagedAppProtection entity
Change Beta Added the members property to the deviceAndAppManagementRoleAssignment entity
Change Beta Added the macOSRestriction property to the deviceEnrollmentPlatformRestrictionsConfiguration entity
Change Beta Added the whenPartnerDevicesWillBeRemovedDateTime and whenPartnerDevicesWillBeMarkedAsNonCompliantDateTime properties to the deviceManagementPartner entity
Change Beta Changed the type of the following properties on the deviceManagementScript entity:
scriptContent from String to Binary
Change Beta Added the smimeEnablePerMessageSwitch property to the iosEasEmailProfileConfiguration entity
Change Beta Added the identityVersion property to the iosLobApp entity
Change Beta Added the faceIdBlocked property to the iosManagedAppProtection entity
Change Beta Added the packageId and identityVersion properties to the managedAndroidLobApp entity
Change Beta Added the azureADDeviceId and remoteAssistanceSessionErrorDetails properties to the managedDevice entity
Change Beta Removed the legacyAppConfiguration property from the managedDeviceMobileAppConfiguration entity
Change Beta Added the identityVersion property to the managedIOSLobApp entity
Change Beta Removed the identityVersion property from the managedMobileLobApp entity
Change Beta Added the publishingState property to the mobileApp entity
Change Beta Added the installState property to the mobileAppInstallStatus entity
Change Beta Removed the identityVersion property from the mobileLobApp entity
Change Beta Added the allowPartnerToCollectIOSApplicationMetadata property to the mobileThreatDefenseConnector entity
Change Beta Removed the members property from the roleAssignment entity
Change Beta Added the lastModifiedDateTime property to the termsAndConditions entity
Change Beta Added the deviceThreatProtectionEnabled and deviceThreatProtectionRequiredSecurityLevel properties to the windows10CompliancePolicy entity
Change Beta Removed the minimumUpdateAutoInstallClassification property from the windows10CompliancePolicy entity
Change Beta Added the privacyBlockPublishUserActivities and privacyBlockActivityFeed properties to the windows10GeneralConfiguration entity
Change Beta Added the configurationAccountType property to the windows10SecureAssessmentConfiguration entity
Change Beta Removed the trustedNetworkDomains property from the windows10VpnConfiguration entity
Change Beta Removed the minimumUpdateAutoInstallClassification property from the windows81CompliancePolicy entity
Change Beta Added the identityVersion property to the windowsAppX entity
Change Beta Added the daysWithoutContactBeforeUnenroll property to the windowsInformationProtectionPolicy entity
Change Beta Added the identityVersion property to the windowsMobileMSI entity
Change Beta Added the identityVersion property to the windowsPhone81AppX entity
Change Beta Added the identityVersion property to the windowsPhoneXAP entity
Change Beta Added the identityVersion property to the windowsUniversalAppX entity
Change Beta Added the domainJoinConfiguration navigation property to the activeDirectoryWindowsAutopilotDeploymentProfile entity
Change Beta Removed the notificationMessageTemplate navigation property from the deviceComplianceActionItem entity
Change Beta Removed the groupAssignments navigation property from the deviceCompliancePolicy entity
Change Beta Added the windowsInformationProtectionNetworkLearningSummaries navigation property to the deviceManagement entity
Change Beta Removed the deviceConfigurationUserStateSummaries navigation property from the deviceManagement entity
Change Beta Changed the type of the following properties on the deviceManagement entity:
roleAssignments from roleAssignment collection to deviceAndAppManagementRoleAssignment collection
Change Beta Added the assignments navigation property to the deviceManagementScript entity
Change Beta Added the smimeEncryptionCertificate navigation property to the iosEasEmailProfileConfiguration entity
Change Beta Changed the type of the following properties on the iosEasEmailProfileConfiguration entity:
smimeSigningCertificate from iosCertificateProfileBase to iosCertificateProfile
Change Beta Removed the vppToken navigation property from the iosVppApp entity
Change Beta Removed the groupAssignments navigation property from the managedEBook entity
Change Beta Removed the groupAssignments navigation property from the mobileApp entity
Change Beta Removed the depOnboardingSettings and appleVolumePurchaseProgramTokens navigation properties from the organization entity
Change Beta Added the deviceEnrollmentConfigurations navigation property to the user entity
Change Beta Removed the windowsCommercialId and windowsCommercialIdLastModifiedTime properties from the deviceManagementSettings complex type
Change Beta Added the showDisplayNameNextToLogo property to the intuneBrand complex type
Change Beta Added the deviceUsageType property to the outOfBoxExperienceSettings complex type
Change Beta Added the supportsUserLicensing and supportsDeviceLicensing properties to the vppLicensingType complex type
Change Beta Removed the actionMessage property from the vppTokenActionResult complex type

Reports APIs

Change type Version Description
Addition v1.0 Added the following APIs:
getTeamsUserActivityUserDetail
getTeamsUserActivityCounts
getTeamsUserActivityUserCounts
getTeamsDeviceUsageUserDetail
getTeamsDeviceUsageUserCounts
getTeamsDeviceUsageDistributionUserCounts

December 2017

Delta query

Change type Version Description
Change v1.0 Add optional query filtering capability to users and groups.

Microsoft Intune APIs

Change type Version Description
Addition Beta Added new entities:
androidForWorkEnrollmentProfile
deviceAndAppManagementRoleAssignment
deviceAndAppManagementRoleDefinition
macOSLobApp
Addition Beta Added new complex types:
resourceAction
updateWindowsDeviceAccountActionParameter
vppTokenActionResult
windowsDeviceAADAccount
windowsDeviceAccount
windowsDeviceADAccount
Addition Beta Added the revokeTokens action on androidForWorkEnrollmentProfile
Addition Beta Added the createToken action on androidForWorkEnrollmentProfile
Addition Beta Added the wipe action on managedDevice
Addition Beta Added the updateWindowsDeviceAccount action on managedDevice
Addition Beta Added the revokeLicenses action on vppToken
Addition Beta Added the getDevicePasscode function on deviceCompliancePolicy collection
Addition Beta Added the getEffectivePermissions function on deviceManagement
Deletion Beta Removed the following entities:
windowsStoreForBusinessApp
Deletion Beta Removed the following complex types:
windowsStoreForBusinessAppAssignmentSettings
Change Beta Added the dateAndTimeBlockChanges property to the androidGeneralDeviceConfiguration entity
Change Beta Removed the enableAuthenticationViaCompanyPortal property from the depEnrollmentProfile entity
Change Beta Removed the windowsStoreForBusinessLastSuccessfulSyncDateTime, isEnabledForWindowsStoreForBusiness, windowsStoreForBusinessLanguage and windowsStoreForBusinessLastCompletedApplicationSyncTime properties from the deviceAppManagement entity
Change Beta Added the maximumDepTokens and intuneAccountId properties to the deviceManagement entity
Change Beta Added the enableAuthenticationViaCompanyPortal property to the enrollmentProfile entity
Change Beta Added the managedDeviceName and partnerReportedThreatState properties to the managedDevice entity
Change Beta Added the installProgressDisplayLevel property to the officeSuiteApp entity
Change Beta Added the resourceScopes property to the roleAssignment entity
Change Beta Added the rolePermissions and isBuiltIn properties to the roleDefinition entity
Change Beta Added the tokenActionResults property to the vppToken entity
Change Beta Added the minimumUpdateAutoInstallClassification property to the windows10CompliancePolicy entity
Change Beta Added the defenderSecurityCenterDisableAppBrowserUI, defenderSecurityCenterDisableFamilyUI, defenderSecurityCenterDisableHealthUI, defenderSecurityCenterDisableNetworkUI, defenderSecurityCenterDisableVirusUI, defenderSecurityCenterOrganizationDisplayName, defenderSecurityCenterHelpEmail, defenderSecurityCenterHelpPhone, defenderSecurityCenterHelpURL, defenderSecurityCenterNotificationsFromApp, defenderSecurityCenterITContactDisplay and applicationGuardAllowVirtualGPU properties to the windows10EndpointProtectionConfiguration entity
Change Beta Added the enableAutomaticRedeployment and authenticationAllowFIDODevice properties to the windows10GeneralConfiguration entity
Change Beta Added the trustedNetworkDomains property to the windows10VpnConfiguration entity
Change Beta Added the minimumUpdateAutoInstallClassification property to the windows81CompliancePolicy entity
Change Beta Added the androidForWorkEnrollmentProfiles navigation property to the deviceManagement entity
Change Beta Added the healthAttestationSupportedStatus property to the deviceHealthAttestationState complex type
Change Beta Added the tpmSpecificationVersion, operatingSystemEdition, deviceFullQualifiedDomainName, deviceGuardVirtualizationBasedSecurityHardwareRequirementState, deviceGuardVirtualizationBasedSecurityState and deviceGuardLocalSystemAuthorityCredentialGuardState properties to the hardwareInformation complex type
Change Beta Added the vpnConfigurationId property to the iosVppAppAssignmentSettings complex type
Change Beta Added the resourceActions property to the rolePermission complex type

Reports APIs

Change type Version Description
Addition v1.0 Added the following APIs:
getEmailActivityUserDetail
getEmailActivityCounts
getEmailActivityUserCounts
getEmailAppUsageUserDetail
getEmailAppUsageAppsUserCounts
getEmailAppUsageUserCounts
getEmailAppUsageVersionsUserCounts
getMailboxUsageDetail
getMailboxUsageMailboxCounts
getMailboxUsageQuotaStatusMailboxCounts
getMailboxUsageStorage
getOffice365ActivationsUserDetail
getOffice365ActivationCounts
getOffice365ActivationsUserCounts
getOffice365ActiveUserDetail
getOffice365ActiveUserCounts
getOffice365ServicesUserCounts
getOffice365GroupsActivityDetail
getOffice365GroupsActivityCounts
getOffice365GroupsActivityGroupCounts
getOffice365GroupsActivityStorage
getOffice365GroupsActivityFileCounts
getOneDriveActivityUserDetail
getOneDriveActivityUserCounts
getOneDriveActivityFileCounts
getOneDriveUsageAccountDetail
getOneDriveUsageAccountCounts
getOneDriveUsageFileCounts
getOneDriveUsageStorage
getSharePointActivityUserDetail
getSharePointActivityFileCounts
getSharePointActivityUserCounts
getSharePointActivityPages
getSharePointSiteUsageDetail
getSharePointSiteUsageFileCounts
getSharePointSiteUsageSiteCounts
getSharePointSiteUsageStorage
getSharePointSiteUsagePages
getSkypeForBusinessActivityUserDetail
getSkypeForBusinessActivityCounts
getSkypeForBusinessActivityUserCounts
getSkypeForBusinessDeviceUsageUserDetail
getSkypeForBusinessDeviceUsageDistributionUserCounts
getSkypeForBusinessDeviceUsageUserCounts
getSkypeForBusinessOrganizerActivityCounts
getSkypeForBusinessOrganizerActivityUserCounts
getSkypeForBusinessOrganizerActivityMinuteCounts
getSkypeForBusinessParticipantActivityCounts
getSkypeForBusinessParticipantActivityUserCounts
getSkypeForBusinessParticipantActivityMinuteCounts
getSkypeForBusinessPeerToPeerActivityCounts
getSkypeForBusinessPeerToPeerActivityUserCounts
getSkypeForBusinessPeerToPeerActivityMinuteCounts
getYammerActivityUserDetail
getYammerActivityCounts
getYammerActivityUserCounts
getYammerDeviceUsageUserDetail
getYammerDeviceUsageDistributionUserCounts
getYammerDeviceUsageUserCounts
getYammerGroupsActivityDetail
getYammerGroupsActivityGroupCounts
getYammerGroupsActivityCounts.
Addition Beta Added the following APIs:
getTeamsUserActivityUserDetail
getTeamsUserActivityCounts
getTeamsUserActivityUserCounts
getTeamsDeviceUsageUserDetail
getTeamsDeviceUsageUserCounts
getTeamsDeviceUsageDistributionUserCounts

November 2017

Azure AD synchronization APIs

Change type Version Description
Addition Beta Added support for Azure AD identity synchronization, including the following resources:
Job
Schema
Template
See the resource topics for details about the methods that are available.

Education APIs

Change type Version Description
Addition Beta Added support for education scenarios, including the following resources:
Schools
Classes
Users
Assignments
Submissions
See the resource topics for details about the methods that are available.

Microsoft Intune APIs

Change type Version Description
Addition Beta Added new entities:
auditEvent
deviceManagementTroubleshootingEvent
deviceSetupConfiguration
enrollmentTroubleshootingEvent
macOSOfficeSuiteApp
microsoftStoreForBusinessApp
ndesConnector
Addition Beta Added new complex types:
auditActor
auditProperty
auditResource
bulkManagedDeviceActionResult
deviceProtectionOverview
microsoftStoreForBusinessAppAssignmentSettings
operatingSystemVersionRange
remoteLockActionResult
Addition Beta Added the executeAction action on managedDevice collection
Addition Beta Added the wipe action on managedDevice
Addition Beta Added the shutDown action on managedDevice
Addition Beta Added the assign action on deviceConfiguration
Addition Beta Added the syncMicrosoftStoreForBusinessApps action on deviceAppManagement
Addition Beta Added the setDefaultProfile action on enrollmentProfile
Addition Beta Added the shareForSchoolDataSyncService action on depOnboardingSetting
Addition Beta Added the unshareForSchoolDataSyncService action on depOnboardingSetting
Addition Beta Added the getAuditCategories function on auditEvent collection
Addition Beta Added the getAuditActivityTypes function on auditEvent collection
Deletion Beta Removed the following entities:
mobileAppIdentifierDeployment
Deletion Beta Removed the following complex types:
windowsInformationProtectionCloudResource
windowsInformationProtectionCloudResourceCollection
Change Beta Changed the following properties on the androidDeviceComplianceLocalActionLockDeviceWithPasscode entity:
passcode from required to optional
Change Beta Added the microsoftStoreForBusinessLastSuccessfulSyncDateTime, isEnabledForMicrosoftStoreForBusiness, microsoftStoreForBusinessLanguage and microsoftStoreForBusinessLastCompletedApplicationSyncTime properties to the deviceAppManagement entity
Change Beta Added the target property to the deviceConfigurationAssignment entity
Change Beta Added the deviceProtectionOverview property to the deviceManagement entity
Change Beta Added the exchangeAlias and exchangeOrganization properties to the deviceManagementExchangeConnector entity
Change Beta Added the appStoreUrl and minimumSupportedOperatingSystem properties to the managedAndroidStoreApp entity
Change Beta Added the remoteAssistanceSessionErrorString property to the managedDevice entity
Change Beta Added the appStoreUrl, applicableDeviceType and minimumSupportedOperatingSystem properties to the managedIOSStoreApp entity
Change Beta Added the notApplicableDeviceCount, pendingInstallDeviceCount, notApplicableUserCount and pendingInstallUserCount properties to the mobileAppInstallSummary entity
Change Beta Removed the targetedSecurityGroupIds and targetedSecurityGroupsCount properties from the targetedManagedAppConfiguration entity
Change Beta Removed the targetedSecurityGroupsCount and targetedSecurityGroupIds properties from the targetedManagedAppProtection entity
Change Beta Added the validOperatingSystemBuildRanges property to the windows10CompliancePolicy entity
Change Beta Added the activeFirewallRequired, uacRequired and validOperatingSystemBuildRanges properties to the windows10MobileCompliancePolicy entity
Change Beta Added the enableExpeditedTelemetryReporting property to the windowsDefenderAdvancedThreatProtectionConfiguration entity
Change Beta Removed the allowedApps, enterpriseCloudResources and targetedSecurityGroupIds properties from the windowsInformationProtection entity
Change Beta Added the ignoreVersionDetection property to the windowsMobileMSI entity
Change Beta Removed the mobileAppIdentifierDeployments navigation property from the androidManagedAppProtection entity
Change Beta Removed the mobileAppIdentifierDeployments navigation property from the defaultManagedAppProtection entity
Change Beta Added the assignments navigation property to the deviceConfiguration entity
Change Beta Removed the deviceConfiguration navigation property from the deviceConfigurationAssignment entity
Change Beta Added the deviceConfiguration navigation property to the deviceConfigurationGroupAssignment entity
Change Beta Added the deviceSetupConfigurations, ndesConnectors, exchangeOnPremisesPolicies, conditionalAccessSettings, auditEvents and troubleshootingEvents navigation properties to the deviceManagement entity
Change Beta Removed the mobileAppIdentifierDeployments navigation property from the iosManagedAppProtection entity
Change Beta Added the windowsProtectionState navigation property to the managedDevice entity
Change Beta Removed the mobileAppIdentifierDeployments and targetedSecurityGroups navigation properties from the targetedManagedAppConfiguration entity
Change Beta Removed the targetedSecurityGroups navigation property from the targetedManagedAppProtection entity
Change Beta Added the deviceManagementTroubleshootingEvents navigation property to the user entity
Change Beta Removed the allowedAppLockerFiles navigation property from the windowsInformationProtection entity
Change Beta Removed the windowsProtectionState navigation property from the windowsManagedDevice entity
Change Beta Added the v11_0 property to the iosMinimumOperatingSystem complex type
Change Beta Added the denied property to the windowsInformationProtectionApp complex type

Reports APIs

Change type Version Description
Addition Beta Added JSON support for the following APIs:
getEmailActivityUserDetail
getEmailActivityCounts
getEmailActivityUserCounts
getEmailAppUsageUserDetail
getEmailAppUsageAppsUserCounts
getEmailAppUsageUserCounts
getEmailAppUsageVersionsUserCounts
getMailboxUsageDetail
getMailboxUsageMailboxCounts
getMailboxUsageQuotaStatusMailboxCounts
getMailboxUsageStorage
getOffice365ActivationsUserDetail
getOffice365ActivationCounts
getOffice365ActivationsUserCounts
getOffice365ActiveUserDetail
getOffice365ActiveUserCounts
getOffice365ServicesUserCounts
getOffice365GroupsActivityDetail
getOffice365GroupsActivityCounts
getOffice365GroupsActivityGroupCounts
getOffice365GroupsActivityStorage
getOffice365GroupsActivityFileCounts
getOneDriveActivityUserDetail
getOneDriveActivityUserCounts
getOneDriveActivityFileCounts
getOneDriveUsageAccountDetail
getOneDriveUsageAccountCounts
getOneDriveUsageFileCounts
getOneDriveUsageStorage
getSharePointActivityUserDetail
getSharePointActivityFileCounts
getSharePointActivityUserCounts
getSharePointActivityPages
getSharePointSiteUsageDetail
getSharePointSiteUsageFileCounts
getSharePointSiteUsageSiteCounts
getSharePointSiteUsageStorage
getSharePointSiteUsagePages
getSkypeForBusinessActivityUserDetail
getSkypeForBusinessActivityCounts
getSkypeForBusinessActivityUserCounts
getSkypeForBusinessDeviceUsageUserDetail
getSkypeForBusinessDeviceUsageDistributionUserCounts
getSkypeForBusinessDeviceUsageUserCounts
getSkypeForBusinessOrganizerActivityCounts
getSkypeForBusinessOrganizerActivityUserCounts
getSkypeForBusinessOrganizerActivityMinuteCounts
getSkypeForBusinessParticipantActivityCounts
getSkypeForBusinessParticipantActivityUserCounts
getSkypeForBusinessParticipantActivityMinuteCounts
getSkypeForBusinessPeerToPeerActivityCounts
getSkypeForBusinessPeerToPeerActivityUserCounts
getSkypeForBusinessPeerToPeerActivityMinuteCounts
getYammerActivityUserDetail
getYammerActivityCounts
getYammerActivityUserCounts
getYammerDeviceUsageUserDetail
getYammerDeviceUsageDistributionUserCounts
getYammerDeviceUsageUserCounts
getYammerGroupsActivityDetail
getYammerGroupsActivityGroupCounts
getYammerGroupsActivityCounts.

Webhooks

Change type Version Description
Breaking change Beta and v1.0 Reduced webhooks maximum length of subscription expiration time for drive root items. The new value is the supported maximum expiration time for drive root items.

October 2017

Azure AD APIs

Change type Version Description
Addition Beta Added the identityProvider entity and the create, list, get, update, and delete operations.

Microsoft Intune APIs

Change type Version Description
Addition Beta Added new entities:
androidDeviceComplianceLocalActionLockDeviceWithPasscode
iosLobAppProvisioningConfigurationAssignment
iosVppEBookAssignment
managedDeviceMobileAppConfigurationAssignment
managedEBookAssignment
managedMobileApp
mobileAppAssignment
termsAndConditionsAssignment
vppToken
windows10PFXImportCertificateProfile
windowsAssignedAccessProfile
windowsDomainJoinConfiguration
Addition Beta Added new complex types:
iosLobAppAssignmentSettings
iosSingleSignOnSettings
iosStoreAppAssignmentSettings
iosVppAppAssignmentSettings
mobileAppAssignmentSettings
proxiedDomain
windowsInformationProtectionProxiedDomainCollection
windowsStoreForBusinessAppAssignmentSettings
Addition Beta Added the assign action on mobileApp
Addition Beta Added the assign action on iosLobAppProvisioningConfiguration
Addition Beta Added the assign action on managedDeviceMobileAppConfiguration
Addition Beta Added the assign action on deviceCompliancePolicy
Addition Beta Added the assignedAccessMultiModeProfiles action on deviceConfiguration
Addition Beta Added the syncLicenses action on vppToken
Addition Beta Added the targetApps action on managedAppPolicy
Addition Beta Added the targetApps action on managedAppProtection
Addition Beta Added the targetApps action on targetedManagedAppConfiguration
Addition Beta Added the assign action on managedEBook
Deletion Beta Removed the following entities:
cloudPkiSubscription
Deletion Beta Removed the following complex types:
cloudPkiAdministratorCredentials
windowsNetworkIsolationCloudResource
windowsNetworkIsolationCloudResourceCollection
windowsNetworkIsolationIPRangeCollection
windowsNetworkIsolationResourceCollection
Change Beta Added the gracePeriodInMinutes property to the androidDeviceComplianceLocalActionBase entity
Change Beta Removed the enableSplitTunneling property from the androidForWorkVpnConfiguration entity
Change Beta Added the versionName and versionCode properties to the androidLobApp entity
Change Beta Added the minimumRequiredPatchVersion and minimumWarningPatchVersion properties to the androidManagedAppProtection entity
Change Beta Added the minimumRequiredPatchVersion and minimumWarningPatchVersion properties to the defaultManagedAppProtection entity
Change Beta Added the target property to the deviceCompliancePolicyAssignment entity
Change Beta Added the singleSignOnSettings property to the iosDeviceFeaturesConfiguration entity
Change Beta Added the versionNumber and buildNumber properties to the iosLobApp entity
Change Beta Added the bundleId property to the iosVppApp entity
Change Beta Added the preSharedKey property to the iosWiFiConfiguration entity
Change Beta Added the versionName and versionCode properties to the managedAndroidLobApp entity
Change Beta Added the periodBeforePinReset property to the managedAppProtection entity
Change Beta Added the subscriberCarrier, meid, totalStorageSpaceInBytes and freeStorageSpaceInBytes properties to the managedDevice entity
Change Beta Removed the enrollmentType property from the managedDevice entity
Change Beta Added the versionNumber and buildNumber properties to the managedIOSLobApp entity
Change Beta Added the displayVersion property to the mobileAppInstallStatus entity
Change Beta Removed the defaultDeviceEnrollmentRestrictions, defaultDeviceEnrollmentWindowsHelloForBusinessSettings and defaultDeviceEnrollmentLimit properties from the organization entity
Change Beta Added the isAssigned property to the targetedManagedAppConfiguration entity
Change Beta Added the isAssigned property to the targetedManagedAppProtection entity
Change Beta Added the activeFirewallRequired, uacRequired, defenderEnabled, defenderVersion, signatureOutOfDate and rtpEnabled properties to the windows10CompliancePolicy entity
Change Beta Added the assignedAccessSingleModeUserName, assignedAccessSingleModeAppUserModelId, microsoftAccountSignInAssistantSettings, authenticationAllowSecondaryDevice, cryptographyAllowFipsAlgorithmPolicy, securityBlockAzureADJoinedDevicesAutoEncryption, systemTelemetryProxyServer, inkWorkspaceAccess, inkWorkspaceBlockSuggestedApps, defenderCloudBlockLevel and defenderCloudExtendedTimeout properties to the windows10GeneralConfiguration entity
Change Beta Added the protectedApps, enterpriseProxiedDomains and isAssigned properties to the windowsInformationProtection entity
Change Beta Added the productVersion property to the windowsMobileMSI entity
Change Beta Added the apps navigation property to the androidManagedAppProtection entity
Change Beta Added the apps navigation property to the defaultManagedAppProtection entity
Change Beta Added the vppTokens navigation property to the deviceAppManagement entity
Change Beta Added the assignments navigation property to the deviceCompliancePolicy entity
Change Beta Removed the deviceCompliancePolicy navigation property from the deviceCompliancePolicyAssignment entity
Change Beta Added the deviceCompliancePolicy navigation property to the deviceCompliancePolicyGroupAssignment entity
Change Beta Added the identityCertificateForClientAuthentication navigation property to the iosDeviceFeaturesConfiguration entity
Change Beta Added the assignments navigation property to the iosLobAppProvisioningConfiguration entity
Change Beta Added the apps navigation property to the iosManagedAppProtection entity
Change Beta Added the assignments navigation property to the managedDeviceMobileAppConfiguration entity
Change Beta Added the assignments navigation property to the managedEBook entity
Change Beta Added the assignments navigation property to the mobileApp entity
Change Beta Added the apps navigation property to the targetedManagedAppConfiguration entity
Change Beta Added the assignments navigation property to the termsAndConditions entity
Change Beta Added the assignedAccessMultiModeProfiles navigation property to the windows10GeneralConfiguration entity
Change Beta Added the protectedAppLockerFiles navigation property to the windowsInformationProtection entity
Change Beta Added the port and forceTls properties to the airPrintDestination complex type
Change Beta Changed the type of the following properties on the deviceCompliancePolicySettingState complex type:
errorCode from Int32 to Int64
Change Beta Changed the type of the following properties on the deviceConfigurationSettingState complex type:
errorCode from Int32 to Int64
Change Beta Changed the type of the following properties on the windowsNetworkIsolationPolicy complex type:
enterpriseCloudResources from windowsNetworkIsolationCloudResourceCollection to proxiedDomain collection
enterpriseInternalProxyServers from windowsNetworkIsolationResourceCollection to String collection
enterpriseIPRanges from windowsNetworkIsolationIPRangeCollection to ipRange collection
enterpriseNetworkDomainNames from windowsNetworkIsolationResourceCollection to String collection
enterpriseProxyServers from windowsNetworkIsolationResourceCollection to String collection
neutralDomainResources from windowsNetworkIsolationResourceCollection to String collection

Microsoft Teams APIs

Change type Version Description
Addition Beta Added new team entity.
Addition Beta Added create, get, and update operations on team entity.

Outlook messages

Change type Version Description
Change v1.0 and beta This behavior enhancement is about getting a shared mail folder or its message contents, when a user has shared a mail folder with the signed-in user, or has delegated the user's mailbox to the signed-in user. In such situations, an app can specify that user's ID or user principal name to get that shared mail folder, or get the messages in that shared calendar, as long as the signed-in user has provided delegated permissions to the app.

Outlook user choices

Change type Version Description
Addition Beta Added the new workingHours property to mailboxSettings. See workingHours resource type for information on the supported use cases.
Addition Beta Added the following new complex types:
workingHours
timeZoneBase
customTimeZone
standardTimeZoneOffset
daylightTimeZoneOffset

Reports APIs

Change type Version Description
Change Beta Added the getEmailActivityUserDetail, getEmailActivityCounts, and getEmailActivityUserCounts APIs. These replaced the EmailActivity API.
Change Beta Added the getEmailAppUsageUserDetail, getEmailAppUsageAppsUserCounts, getEmailAppUsageUserCounts, and getEmailAppUsageVersionsUserCounts APIs. These replaced the EmailAppUsage API.
Change Beta Added the getMailboxUsageDetail, getMailboxUsageMailboxCounts, getMailboxUsageQuotaStatusMailboxCounts, and getMailboxUsageStorage APIs. These replaced the MailboxUsage API.
Change Beta Added the getOffice365ActivationsUserDetail, getOffice365ActivationCounts, and getOffice365ActivationsUserCounts APIs. These replaced the Office365Activations API.
Change Beta Added the getOffice365ActiveUserDetail, getOffice365ActiveUserCounts, and getOffice365ServicesUserCounts APIs. These replaced the Office365ActiveUser API.
Change Beta Added the getOffice365GroupsActivityDetail, getOffice365GroupsActivityCounts,getOffice365GroupsActivityGroupCounts, getOffice365GroupsActivityStorage, and getOffice365GroupsActivityFileCounts APIs. These replaced the Office365GroupsActivity API.
Change Beta Added the getOneDriveActivityUserDetail, getOneDriveActivityUserCounts, and getOneDriveActivityFileCounts APIs. These replaced the OneDriveActivity API.
Change Beta Added the getOneDriveUsageAccountDetail, getOneDriveUsageAccountCounts, getOneDriveUsageFileCounts, and getOneDriveUsageStorage APIs. These replaced the OneDriveUsage API.
Change Beta Added the getSharePointActivityUserDetail, getSharePointActivityFileCounts, getSharePointActivityUserCounts, and getSharePointActivityPages APIs. These replaced the SharePointActivity API.
Change Beta Added the getSharePointSiteUsageDetail, getSharePointSiteUsageFileCounts, getSharePointSiteUsageSiteCounts, getSharePointSiteUsageStorage, and getSharePointSiteUsagePages APIs. These replaced the SharePointSiteUsage API.
Change Beta Added the getSkypeForBusinessActivityUserDetail, getSkypeForBusinessActivityCounts, and getSkypeForBusinessActivityUserCounts APIs. These replaced the SfbActivity API.
Change Beta Added the getSkypeForBusinessDeviceUsageUserDetail, getSkypeForBusinessDeviceUsageDistributionUserCounts, and getSkypeForBusinessDeviceUsageUserCounts APIs. These replaced the SfbDeviceUsage API.
Change Beta Added the getSkypeForBusinessOrganizerActivityCounts, getSkypeForBusinessOrganizerActivityUserCounts, and getSkypeForBusinessOrganizerActivityMinuteCounts APIs. These replaced the SfbOrganizerActivity API.
Change Beta Added the getSkypeForBusinessParticipantActivityCounts, getSkypeForBusinessParticipantActivityUserCounts, and getSkypeForBusinessParticipantActivityMinuteCounts APIs. These replaced the SfbParticipantActivity API.
Change Beta Added the getSkypeForBusinessPeerToPeerActivityCounts, getSkypeForBusinessPeerToPeerActivityUserCounts, and getSkypeForBusinessPeerToPeerActivityMinuteCounts APIs. These replaced the SfbP2PActivity API.
Change Beta Added the getYammerActivityUserDetail, getYammerActivityCounts, and getYammerActivityUserCounts APIs. These replaced the YammerActivity API.
Change Beta Added the getYammerDeviceUsageUserDetail, getYammerDeviceUsageDistributionUserCounts, and getYammerDeviceUsageUserCounts APIs. These replaced the YammerDeviceUsage API.
Change Beta Added the getYammerGroupsActivityDetail, getYammerGroupsActivityGroupCounts, and getYammerGroupsActivityCounts APIs. These replaced the YammerGroupsActivity API.

September 2017

Intune APIs

Change type Version Description
Addition Beta Added new entities:
activeDirectoryWindowsAutopilotDeploymentProfile
azureADWindowsAutopilotDeploymentProfile
deviceEnrollmentConfiguration
deviceEnrollmentLimitConfiguration
deviceEnrollmentPlatformRestrictionsConfiguration
deviceEnrollmentWindowsHelloForBusinessConfiguration
deviceManagementPartner
enrollmentConfigurationAssignment
windows10EnrollmentCompletionPageConfiguration
windows10NetworkBoundaryConfiguration
windowsAutopilotDeploymentProfile
windowsAutopilotDeviceIdentity
windowsAutopilotSettings
Addition Beta Added new complex types:
adminConsent
allDevicesAssignmentTarget
allLicensedUsersAssignmentTarget
deviceAndAppManagementAssignmentTarget
deviceEnrollmentPlatformRestriction
deviceHealthAttestationState
exclusionGroupAssignmentTarget
groupAssignmentTarget
outOfBoxExperienceSettings
windowsFirewallNetworkProfile
windowsNetworkIsolationCloudResource
windowsNetworkIsolationCloudResourceCollection
windowsNetworkIsolationIPRangeCollection
windowsNetworkIsolationPolicy
windowsNetworkIsolationResourceCollection
Addition Beta Added the sync action on windowsAutopilotSettings
Addition Beta Added the assign action on windowsAutopilotDeploymentProfile
Addition Beta Added the localActions action on deviceCompliancePolicy
Addition Beta Added the setPriority action on deviceEnrollmentConfiguration
Addition Beta Added the assign action on deviceEnrollmentConfiguration
Addition Beta Added the uploadDepToken action on depOnboardingSetting collection
Addition Beta Added the syncWithAppleDeviceEnrollmentProgram action on depOnboardingSetting collection
Addition Beta Added the updateMobileAppIdentifierDeployments action on managedAppProtection
Addition Beta Added the assign action on targetedManagedAppProtection
Addition Beta Added the assign action on targetedManagedAppConfiguration
Addition Beta Added the assign action on windowsInformationProtection
Addition Beta Added the getEncryptionPublicKey function on depOnboardingSetting collection
Change Beta Added the requireSafetyNetAttestationBasicIntegrity, requireSafetyNetAttestationCertifiedDevice, requireGooglePlayServices, requireUpToDateSecurityProviders, requireCompanyPortalAppIntegrity and conditionStatementId properties to the androidCompliancePolicy entity
Change Beta Added the requireAppVerify, requireSafetyNetAttestationBasicIntegrity, requireSafetyNetAttestationCertifiedDevice, requireGooglePlayServices, requireUpToDateSecurityProviders and requireCompanyPortalAppIntegrity properties to the androidForWorkCompliancePolicy entity
Change Beta Added the blockCrossProfileCopyPaste and requireAppVerify properties to the androidForWorkGeneralDeviceConfiguration entity
Change Beta Added the kioskModeApps and requireAppVerify properties to the androidGeneralDeviceConfiguration entity
Change Beta Removed the kioskModeManagedApps property from the androidGeneralDeviceConfiguration entity
Change Beta Removed the cloudPkiProvider, createdDateTime, description, lastModifiedDateTime, displayName, syncStatus, lastSyncError, lastSyncDateTime, credentials, trustedRootCertificate and version properties from the cloudPkiSubscription entity
Change Beta Removed the assignmentStatus, assignmentProgress and assignmentErrorMessage properties from the deviceConfiguration entity
Change Beta Added the adminConsent property to the deviceManagement entity
Change Beta Added the vppTokenOrganizationName, vppTokenAccountType and vppTokenAppleId properties to the iosVppApp entity
Change Beta Added the deviceEnrollmentType, wiFiMacAddress and deviceHealthAttestationState properties to the managedDevice entity
Change Beta Added the legacyAppConfiguration property to the managedDeviceMobileAppConfiguration entity
Change Beta Added the notApplicableCount property to the managedDeviceMobileAppConfigurationDeviceSummary entity
Change Beta Added the notApplicableCount property to the managedDeviceMobileAppConfigurationUserSummary entity
Change Beta Added the firewallBlockStatefulFTP, firewallIdleTimeoutForSecurityAssociationInSeconds, firewallPreSharedKeyEncodingMethod, firewallIPSecExemptionsAllowNeighborDiscovery, firewallIPSecExemptionsAllowICMP, firewallIPSecExemptionsAllowRouterDiscovery, firewallIPSecExemptionsAllowDHCP, firewallCertificateRevocationListCheckMethod, firewallMergeKeyingModuleSettings, firewallPacketQueueingMethod, firewallProfileDomain, firewallProfilePublic, firewallProfilePrivate, defenderAttackSurfaceReductionExcludedPaths, defenderOfficeAppsOtherProcessInjectionType, defenderOfficeAppsExecutableContentCreationOrLaunchType, defenderOfficeAppsLaunchChildProcessType, defenderOfficeMacroCodeAllowWin32ImportsType, defenderScriptObfuscatedMacroCodeType, defenderScriptDownloadedPayloadExecutionType, defenderEmailContentExecutionType, defenderGuardMyFoldersType, defenderGuardedFoldersAllowedAppPaths, defenderAdditionalGuardedFolders, defenderNetworkProtectionType, defenderExploitProtectionXml, defenderExploitProtectionXmlFileName, defenderSecurityCenterBlockExploitProtectionOverride, appLockerApplicationControl, applicationGuardBlockClipboardSharing, applicationGuardAllowPrintToPDF, applicationGuardAllowPrintToXPS, applicationGuardAllowPrintToLocalPrinters, applicationGuardAllowPrintToNetworkPrinters and bitLockerDisableWarningForOtherDiskEncryption properties to the windows10EndpointProtectionConfiguration entity
Change Beta Added the displayAppListWithGdiDPIScalingTurnedOn, displayAppListWithGdiDPIScalingTurnedOff, messagingBlockSync, messagingBlockMMS and messagingBlockRichCommunicationServices properties to the windows10GeneralConfiguration entity
Change Beta Removed the bluetoothDeviceName property from the windows10GeneralConfiguration entity
Change Beta Removed the deviceAccountBlockExchangeServices, deviceAccountEmailAddress, deviceAccountExchangeServerAddress, deviceAccountRequirePasswordRotation and deviceAccountSessionInitiationProtocolAddress properties from the windows10TeamGeneralConfiguration entity
Change Beta Added the localActions navigation property to the androidCompliancePolicy entity
Change Beta Added the windowsAutopilotSettings, windowsAutopilotDeviceIdentities, windowsAutopilotDeploymentProfiles, deviceEnrollmentConfigurations, deviceManagementPartners and depOnboardingSettings navigation properties to the deviceManagement entity
Change Beta Removed the cloudPkiSubscriptions navigation property from the deviceManagement entity
Change Beta Added the assignments navigation property to the targetedManagedAppConfiguration entity
Change Beta Added the assignments navigation property to the targetedManagedAppProtection entity
Change Beta Added the assignments navigation property to the windowsInformationProtection entity

OneDrive

Change type Version Description
Addition v1.0 Added the system property to the Drive resource.
Addition v1.0 Added the list relationship to the Drive resource.
Addition v1.0 Added the listItem relationship to the DriveItem resource.
Addition v1.0 Added the list and listItem relationships to the SharedDriveItem resource.
Addition v1.0 Added new complex types: FolderView
Addition v1.0 Added the view property to the Folder complex type.
Addition v1.0 Added the driveType property to the ItemReference complex type.
Addition v1.0 Added the audioBitsPerSample, audioChannels, audioFormat, audioSamplesPerSecond, fourCC and frameRate properties to the Video complex type.
Addition beta Added the system property to the Drive resource.
Addition beta Added the activities relationship to the Drive resource.
Addition beta Added the publication property to the DriveItem resource.
Addition beta Added the activities and versions relationships to the DriveItem resource.
Addition beta Added new entities: DriveItemVersion, ItemActivity.
Addition beta Added new complex types: CommentAction, CreateAction, DeleteAction, EditAction, ItemActionSet, ItemActivityTimeSet, MentionAction, MoveAction, PublicationFacet, RenameAction, RestoreAction, ShareAction, and VersionAction.
Addition beta Added the driveType property to the ItemReference complex type.
Deletion beta Removed the tenantId property from SharepointIds complex type.
Addition v1.0 Added the audioBitsPerSample, audioChannels, audioFormat, audioSamplesPerSecond, fourCC and frameRate properties to the Video complex type.
Addition beta Added the CheckIn and CheckOut actions on the DriveItem resource.
Addition beta Added the expirationDateTime, password, message, and recipients properties on the CreateLink action on a DriveItem resource.

Outlook calendar

Change type Version Description
Addition Beta Added the findRoomLists and findRooms functions to the user entity.
Addition Beta Added the locations property to the event entity to support organizing an event that attendees can attend from more than one location.
Addition Beta Added the locationType property to the location complex type.
Addition Beta Added the uniqueId and uniqueIdType properties to the location complex type. These properties are only for internal use at this point.
Change v1.0 and beta This behavior enhancement is about getting a shared calendar or its event contents, when a user has shared a calendar with the signed-in user, or has delegated the user's mailbox to the signed-in user. In such situations, an app can specify that user's ID or user principal name to get that shared calendar, or get the events in that shared calendar, as long as the signed-in user has provided delegated permissions to the app.

Outlook contacts

Change type Version Description
Change v1.0 and beta This behavior enhancement is about getting a shared contact folder or its contact contents, when a user has shared a contact folder with the signed-in user, or has delegated the user's mailbox to the signed-in user. In such situations, an app can specify that user's ID or user principal name to get that shared contact folder, or get the contacts in that shared folder, as long as the signed-in user has provided delegated permissions to the app.

Outlook mail

Change type Version Description
Addition Beta Added the internetMessageHeaders property to the message entity.
Addition Beta Added the internetMessageHeader complex type.
Addition Beta Added the messageRules navigation property to the mailFolder entity. messageRules is a collection of messageRule instances.
Addition Beta Added the messageRule entity, and messageRuleActions, messageRulePredicates, and sizeRange complex types.
Addition Beta Added the following CRUD operations for message rules: create, list, get, update, and delete.

Outlook user choices

Change type Version Description
Addition Beta Added the new masterCategories navigation property to the outlookUser entity. masterCategories is a collection of outlookCategory objects.
Addition Beta Added the outlookCategory entity.
Addition Beta Added the following CRUD operations for outlookCategory: create, get, update, and delete.
Addition Beta Added the new supportedLanguages function to the outlookUser entity.
Addition Beta Added the new supportedTimeZones function to the outlookUser entity.

SharePoint lists

Change type Version Description
Addition v1.0 Added new entities: ColumnDefinition, ColumnLink, ContentType, List, ListItem.
Addition v1.0 Added the columns, contentTypes, items, and lists relationships to the Site resource.
Addition v1.0 Added new complex types: BooleanColumn, CalculatedColumn, ChoiceColumn, ContentTypeInfo, ContentTypeOrder, CurrencyColumn, DateTimeColumn, DefaultColumnValue, ListInfo, LookupColumn, NumberColumn, PersonOrGroupColumn, SystemFacet, TextColumn.
Addition beta Added new entities: BaseItemVersion, ColumnLink, ContentType, ListItemVersion,
Addition beta Added the columnGroup, currency, defaultValue and displayName properties to ColumnDefinition.
Addition beta Added the displayName and system properties to the List resource.
Addition beta Added the activities and contentTypes relationships to the List resource.
Addition beta Added the contentType property to the ListItem resource.
Addition beta Added the activities and versions relationships to the ListItem resource.
Addition beta Added the contentTypes relationship to the Site resource.
Addition beta Added the outputType property to the BooleanColumn type.
Addition beta Added new complex types: ContentTypeInfo, ContentTypeOrder, CurrencyColumn, and SystemFacet.
Addition beta Added the contentTypesEnabled property to the ListInfo complex type.
Addition beta Added the allowUnlimitedLength property on the LookupColumn complex type.
Change beta Renamed the allowMultipleValue property to allowMultipleValues on the LookupColumn complex type.
Change beta Renamed the chooseFrom property to chooseFromType on PersonOrGroupColumn complex type.
Deletion beta Removed the locale property on the NumberColumn complex type.
Deletion beta Removed the enforceUniqueValues property from PersonOrGroupColumn complex type.

SharePoint sites

Change type Version Description
Addition beta Added dataLocationCode and root properties to the SiteCollection complex type.

August 2017

Group lifecycle policy

Change type Version Description
Addition Beta Added groupLifecyclePolicy entity.
Addition Beta Added the following APIs for group lifecycle policy: create, list, get, update, delete, add group, remove group, and renew a group.
Addition Beta Added List groupLifecylePolicies function to group entity.

Intune APIs

Change type Version Description
Addition Beta Added new entity:
windowsPrivacyDataAccessControlItem
Addition Beta Added new complex types:
configurationManagerClientEnabledFeatures
windowsDefenderScanActionResult
Addition Beta Added the windowsDefenderScan action on managedDevice
Addition Beta Added the windowsDefenderUpdateSignatures action on managedDevice
Addition Beta Added the windowsPrivacyAccessControls action on deviceConfiguration
Change Beta Added the automaticallyUpdateApps and countryOrRegion properties to the appleVolumePurchaseProgramToken entity
Change Beta Added the enableAuthenticationViaCompanyPortal property to the depEnrollmentProfile entity
Change Beta Added the notificationMessageCCList property to the deviceComplianceActionItem entity
Change Beta Added the notApplicableCount property to the deviceComplianceDeviceOverview entity
Change Beta Added the notApplicableCount property to the deviceComplianceUserOverview entity
Change Beta Added the notApplicableCount property to the deviceConfigurationDeviceOverview entity
Change Beta Added the notApplicableCount property to the deviceConfigurationUserOverview entity
Change Beta Added the configurationManagerClientEnabledFeatures property to the managedDevice entity
Change Beta Removed the intuneBrand property from the organization entity
Change Beta Added the smartScreenEnableInShell, smartScreenBlockOverrideForFiles, applicationGuardEnabled, applicationGuardBlockFileTransfer, applicationGuardBlockNonEnterpriseContent, applicationGuardAllowPersistence and applicationGuardForceAuditing properties to the windows10EndpointProtectionConfiguration entity
Change Beta Added the searchBlockDiacritics, searchDisableAutoLanguageDetection, searchDisableIndexingEncryptedItems, searchEnableRemoteQueries, searchDisableUseLocation, searchDisableIndexerBackoff, searchDisableIndexingRemovableDrive, searchEnableAutomaticIndexSizeManangement, smartScreenEnableAppInstallControl and privacyAdvertisingId properties to the windows10GeneralConfiguration entity
Change Beta Removed the settingsDeviceName property from the windows10TeamGeneralConfiguration entity
Change Beta Removed the restartMode property from the windowsUpdateForBusinessConfiguration entity
Change Beta Added the detectedApps and managedDevices navigation properties to the deviceManagement entity
Change Beta Added the privacyAccessControls navigation property to the windows10GeneralConfiguration entity
Change Beta Added the secureByDefault property to the deviceManagementSettings complex type
Change Beta Added the restartMode property to the windowsUpdateScheduledInstall complex type

OneNote

Change type Version Description
Addition v1.0 and Beta Added the onenote navigation property to site.
Addition Beta Added the target siteCollectionId and target siteId parameters for the copy operations. For example: CopyNotebook.

People

Change type Version Description
Addition v1.0 Added the People APIs to v1.0. For details about the People API, see Get relevant information about people.
Addition v1.0 Added People.Read.All permission. To learn more, please see Permissions.
Addition v1.0 Added the personType resource.
Change v1.0 The scoredEmailAddress resource replaced the rankedEmailAddress resource.
Change v1.0 The person resource was updated as follows:
  • The scoredEmailAddresses property (a collection of scoredEmailAddress type) replaced the emailAddresses property
  • The jobTitle property replaced the title property
  • Removed sources and mailboxType properties
  • The personType property is now of personType type instead of string type and replaces functionality of the previous sources and mailboxType properties
  • Added imAddress property
Deletion v1.0 Removed the personDataSource resource.

User

Change type Version Description
Addition beta Added employeeId property to user

July 2017

Group settings

Change type Version Description
Addition v1.0 Added support for group settings.
New resource types: groupSetting, groupSettingTemplate, settingValue, and settingTemplateValue
Change v1.0 Added property classification and navigation property settings to group

Intune APIs

Change type Version Description
Addition Beta Added the assign action on iosMobileAppConfiguration
Addition Beta Added the syncDevice action on managedDevice
Change Beta Added the appsInstallAllowList, appsLaunchBlockList and appsHideList properties to the androidGeneralDeviceConfiguration entity
Change Beta Added the disableAppEncryptionIfDeviceEncryptionIsEnabled property to the androidManagedAppProtection entity
Change Beta Added the disableAppEncryptionIfDeviceEncryptionIsEnabled property to the defaultManagedAppProtection entity
Change Beta Added the complianceGracePeriodExpirationDateTime property to the deviceComplianceDeviceStatus entity
Change Beta Added the complianceGracePeriodExpirationDateTime property to the deviceComplianceSettingState entity
Change Beta Added the complianceGracePeriodExpirationDateTime property to the deviceConfigurationDeviceStatus entity
Change Beta Added the subscriptions property to the deviceManagement entity
Change Beta Added the version property to the deviceManagementExchangeConnector entity
Change Beta Added the utcTimeOffsetInMinutes property to the iosUpdateConfiguration entity
Change Beta Added the complianceGracePeriodExpirationDateTime property to the iosUpdateDeviceStatus entity
Change Beta Added the preSharedKey property to the macOSWiFiConfiguration entity
Change Beta Added the phoneNumber, androidSecurityPatchLevel and userDisplayName properties to the managedDevice entity
Change Beta Added the userName, deviceModel, platform and complianceGracePeriodExpirationDateTime properties to the managedDeviceMobileAppConfigurationDeviceStatus entity
Change Beta Added the userPrincipalName property to the mobileAppInstallStatus entity
Change Beta Added the overrideDefaultRule property to the onPremisesConditionalAccessSettings entity
Change Beta Added the userPrincipalName property to the userAppInstallStatus entity
Change Beta Added the connectAppBlockAutoLaunch, deviceAccountBlockExchangeServices, deviceAccountEmailAddress, deviceAccountExchangeServerAddress, deviceAccountRequirePasswordRotation, deviceAccountSessionInitiationProtocolAddress, settingsBlockMyMeetingsAndFiles, settingsBlockSessionResume, settingsBlockSigninSuggestions, settingsDefaultVolume, settingsScreenTimeoutInMinutes, settingsSessionTimeoutInMinutes and settingsSleepTimeoutInMinutes properties to the windows10TeamGeneralConfiguration entity
Change Beta Added the deploymentSummary navigation property to the defaultManagedAppProtection entity
Change Beta Added the settingName, userId, userName, userEmail and currentValue properties to the deviceCompliancePolicySettingState complex type
Change Beta Added the settingName, userId, userName, userEmail and currentValue properties to the deviceConfigurationSettingState complex type
Change Beta Added the unknownCount property to the deviceOperatingSystemSummary complex type

June 2017

Project Rome

Change type Version Description
Addition Beta Added the following resources and APIs:
Activity
Create or replace an activity
Delete an activity
History item
Create or replace a history item
Delete a history item

Outlook calendar

Change type Version Description
Addition v1.0 Promoted the following 4 calendar properties to v1.0: canEdit, canShare, canViewPrivateItems, and owner.

Intune APIs

Change type Version Description
Addition Beta Added new entities:
defaultDeviceCompliancePolicy
deviceConfigurationUserStateSummary
deviceManagementScriptDeviceState
deviceManagementScriptRunSummary
deviceManagementScriptUserState
iosUpdateDeviceStatus
windowsManagedDevice
windowsManagementAppHealthState
windowsManagementAppHealthSummary
Addition Beta Added new complex types:
bitLockerFixedDrivePolicy
bitLockerRecoveryOptions
bitLockerRemovableDrivePolicy
deleteUserFromSharedAppleDeviceActionResult
iosNetworkUsageRule
Deletion Beta Removed the following entities:
deviceManagementScriptState
Deletion Beta Removed the wipeByDeviceTag action on user
Change Beta Added the innerAuthenticationProtocolForEapTtls, innerAuthenticationProtocolForPeap and outerIdentityPrivacyTemporaryValue properties to the androidEnterpriseWiFiConfiguration entity
Change Beta Removed the nonEapAuthenticationMethodForEapTtls, nonEapAuthenticationMethodForPeap and enableOuterIdentityPrivacy properties from the androidEnterpriseWiFiConfiguration entity
Change Beta Added the deployedAppCount property to the androidManagedAppProtection entity
Change Beta Removed the instanceDisplayName and settingPlatform properties from the complianceSettingStateSummary entity
Change Beta Added the deployedAppCount property to the defaultManagedAppProtection entity
Change Beta Added the excludeGroup property to the deviceCompliancePolicyGroupAssignment entity
Change Beta Removed the instanceDisplayName and settingPlatform properties from the deviceCompliancePolicySettingStateSummary entity
Change Beta Removed the devicePlatform property from the deviceComplianceSettingState entity
Change Beta Added the assignmentStatus, assignmentProgress and assignmentErrorMessage properties to the deviceConfiguration entity
Change Beta Added the intuneBrand property to the deviceManagement entity
Change Beta Added the enforceSignatureCheck and fileName properties to the deviceManagementScript entity
Change Beta Added the innerAuthenticationProtocolForEapTtls and outerIdentityPrivacyTemporaryValue properties to the iosEnterpriseWiFiConfiguration entity
Change Beta Removed the nonEapAuthenticationMethodForEapTtls and enableOuterIdentityPrivacy properties from the iosEnterpriseWiFiConfiguration entity
Change Beta Added the classroomAppForceUnpromptedScreenObservation, keyboardBlockDictation, networkUsageRules and wiFiConnectOnlyToConfiguredNetworks properties to the iosGeneralDeviceConfiguration entity
Change Beta Added the deployedAppCount property to the iosManagedAppProtection entity
Change Beta Added the preSharedKey property to the iosWiFiConfiguration entity
Change Beta Added the innerAuthenticationProtocolForEapTtls and outerIdentityPrivacyTemporaryValue properties to the macOSEnterpriseWiFiConfiguration entity
Change Beta Removed the nonEapAuthenticationMethodForEapTtls and enableOuterIdentityPrivacy properties from the macOSEnterpriseWiFiConfiguration entity
Change Beta Removed the lastModifiedTime and deployedAppCount properties from the managedAppPolicy entity
Change Beta Added the serialNumber property to the managedDevice entity
Change Beta Removed the managementAgents property from the managedDevice entity
Change Beta Added the deployedAppCount property to the targetedManagedAppConfiguration entity
Change Beta Added the bitLockerFixedDrivePolicy and bitLockerRemovableDrivePolicy properties to the windows10EndpointProtectionConfiguration entity
Change Beta Added the enterpriseCloudPrintDiscoveryEndPoint, enterpriseCloudPrintOAuthAuthority, enterpriseCloudPrintOAuthClientIdentifier, enterpriseCloudPrintResourceIdentifier, enterpriseCloudPrintDiscoveryMaxLimit, enterpriseCloudPrintMopriaDiscoveryResourceIdentifier, edgeBlockAddressBarDropdown, edgeBlockCompatibilityList, edgeClearBrowsingDataOnExit, edgeAllowStartPagesModification, edgeDisableFirstRunPage, edgeBlockLiveTileDataCollection and edgeSyncFavoritesWithInternetExplorer properties to the windows10GeneralConfiguration entity
Change Beta Added the availableVersion property to the windowsManagementApp entity
Change Beta Removed the onboardingStatus, deployedVersion and lastModifiedTime properties from the windowsManagementApp entity
Change Beta Added the packageIdentityName property to the windowsStoreForBusinessApp entity
Change Beta Added the mobileAppIdentifierDeployments and deploymentSummary navigation properties to the androidManagedAppProtection entity
Change Beta Added the mobileAppIdentifierDeployments navigation property to the defaultManagedAppProtection entity
Change Beta Added the deviceConfigurationUserStateSummaries and iosUpdateStatuses navigation properties to the deviceManagement entity
Change Beta Removed the complianceSettingStateSummaries navigation property from the deviceManagement entity
Change Beta Added the runSummary, deviceRunStates and userRunStates navigation properties to the deviceManagementScript entity
Change Beta Removed the runStates navigation property from the deviceManagementScript entity
Change Beta Added the mobileAppIdentifierDeployments and deploymentSummary navigation properties to the iosManagedAppProtection entity
Change Beta Removed the mobileAppIdentifierDeployments and deploymentSummary navigation properties from the managedAppPolicy entity
Change Beta Added the mobileAppIdentifierDeployments and deploymentSummary navigation properties to the targetedManagedAppConfiguration entity
Change Beta Added the healthSummary and healthStates navigation properties to the windowsManagementApp entity
Change Beta Added the applicationId, appName, platformId, userFailures and deviceFailures properties to the appInstallationFailure complex type
Change Beta Added the encryptionMethod, startupAuthenticationRequired, startupAuthenticationBlockWithoutTpmChip, startupAuthenticationTpmUsage, startupAuthenticationTpmPinUsage, startupAuthenticationTpmKeyUsage, startupAuthenticationTpmPinAndKeyUsage, recoveryOptions and prebootRecoveryEnableMessageAndUrl properties to the bitLockerSystemDrivePolicy complex type
Change Beta Removed the settingName, userId, userName, userEmail and currentValue properties from the deviceCompliancePolicySettingState complex type
Change Beta Removed the settingName, userId, userName, userEmail and currentValue properties from the deviceConfigurationSettingState complex type
Change Beta Added the windowsCommercialId and windowsCommercialIdLastModifiedTime properties to the deviceManagementSettings complex type
Change Beta Added the address property to the vpnServer complex type

May 2017

Application API changes

Change type Version Description
Change Beta Application API update. This is first set of changes including property renaming and restructuring of the application entity.
New entities: api, informationalUrl, installedClient, permissionScope, preauthorizedApplication, web.
Removed properties: addIns, appRoles, availableToOtherOrganizations, knownClientApplications, oauth2AllowUrlPathMatching, recordConsentConditions.
Renamed properties: appId to id, identifierUris to applicationAliases, availableToOtherTenants to orgRestrictions, mainLogo to logo, oauth2Permissions to publishedPermissionsScopes, publicClient to allowPublicClient, replyUrls to redirectUrls.
New properties: tags.

Remove Deprecated Planner API

Change type Version Description
Deletion Beta Removed the following entities:
task
plan
bucket
taskDetails
planDetails
taskBoardTaskFormat
planTaskBoard

Project Rome

Change type Version Description
Addition Beta Added support for Project Rome, including getting a list of devices, sending a command to a device, and checking the status of a command.
Addition Beta Added support for user activities and historyItems, including upserting an activity and upserting a historyItem.

Administrative units property changes

Change type Version Description
Change Beta Changed roleMemberInfo property type to identity for scopedRoleMembership entity
Change Beta Changed navigation property scopedAdministratorOf to scopedRoleMemberOf for user entity
Change Beta Changed navigation property scopedAdministrators to scopedRoleMembers for administrativeUnit entity
Change Beta Changed navigation property scopedAdministrators to scopedMembers for directoryRole entity

Add users and groups webhook support in preview

Change type Version Description
Change Beta Added support to webhooks for users and groups.

Add delta query to v1.0

Change type Version Description
Addition v1.0 Add delta function support to v1.0. 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
Get incremental changes to messages in a folder
Get incremental changes to users
Change Beta Add additional optional query filtering capability (by id) to users and groups.

Added user resource support for deleted items

Change type Version Description
Addition Beta Added support for restoring and permanently deleting users.

Added OnPremisesProvisioningError

Change type Version Description
Addition beta New entity: OnPremisesProvisioningError
Change beta Added OnPremisesProvisioningError property to user, group, and orgcontact

Added deletedDateTime property

Change type Version Description
Change beta Added deletedDateTime property to user entity.
Change beta Added deletedDateTime property to group entity.
Change beta Added deletedDateTime property to application entity.

Added domain operations to v1.0

Change type Version Description
Addition v1.0 Added operations on domains.
New entities:
domain
domainDnsRecord
domainDnsCnameRecord
domainDnsMxRecord
domainDnsSrvRecord
domainDnsTxtRecord
domainDnsUnavailableRecord
New actions:
verify

Added contracts to v1.0

Change type Version Description
Addition v1.0 New entity:
contract

Added licenseDetails to v1.0

Change type Version Description
Addition v1.0 New entity:
licenseDetails
Change v1.0 New licensedetails navigation property on users

Drive API

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.

Extensions (open extensions)

Change type Version Description
Addition v1.0 Support for openTypeExtension in the following resources - device, group,organization, user.
Addition v1.0 and beta When the user is signed-in with a personal Microsoft account, support for open extensions in the following resources - event, post, group, message, contact, and user. (This is in addition to these resources, plus device, group, organization and user, supporting open extensions when the user signs in using a work or school account.)
Addition v1.0 and beta Support for $expand to get open extensions in the following resources: device, group,organization, post, user.
Addition Beta Support for $expand to get open extensions in administrativeUnit.

Extensions (schema extensions)

Change type Version Description
Addition v1.0 New resource schemaExtension and CRUD methods to manage extension definitions for the following resources: contact, device, event, group, message, organization, post, user. Note that support for administrativeUnit is still limited to the beta version as before.
Addition v1.0 The existing POST, GET, and PATCH methods of the following resources - contact, device, event, group, message, organization, post, user - now support adding, getting, and updating or deleting custom data stored as schema extensions in the corresponding resource instances.
Addition v1.0 and beta You can now use $filter to look for resource instances with properties that match specific extension property values, such as extension name. See this example for details.
Change v1.0 and beta Deleting a schema extension definition no longer affects accessing custom data that has been added based on that definition.
Change v1.0 and beta You can now set a schema extension complex type to null, to remove a schema extension from a resource instance.

Group

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

Insights APIs

Change type Version Description
Addition Beta Added Shared API.
New resources:
sharingDetail
insightIdentity
Addition Beta Added Used API.
New resources:
usageDetails
Change Beta New Type property in the:
resourceVisualization resource.
Deletion Beta Removed the following entities:
workingWith
trendingAround

Intune APIs

Change type Version Description
Addition Beta Added new entities:
androidForWorkMobileAppConfiguration
cartToClassAssociation
deviceCompliancePolicySettingStateSummary
eBookInstallSummary
eBookVppGroupAssignment
iosUpdateConfiguration
remoteAssistancePartner
windows10EndpointProtectionConfiguration
windowsDeviceMalwareState
windowsInformationProtectionAppLearningSummary
windowsMalwareInformation
windowsProtectionState
Addition Beta Added new complex types:
androidPermissionAction
bitLockerSystemDrivePolicy
defenderDetectedMalwareActions
settingSource
Addition Beta Added the assign action on managedEBook
Addition Beta Added the beginOnboarding action on remoteAssistancePartner
Addition Beta Added the disconnect action on remoteAssistancePartner
Deletion Beta Removed the following entities:
outlookTask
outlookTaskFolder
outlookTaskGroup
outlookUser
windowsManagementAppHealthState
Deletion Beta Removed the following complex types:
applePushNotificationCertificateSetting
eventCreationOptions
Change Beta Added the workProfilePasswordBlockFingerprintUnlock, workProfilePasswordBlockTrustAgents, workProfilePasswordExpirationDays, workProfilePasswordMinimumLength, workProfilePasswordMinutesOfInactivityBeforeScreenTimeout, workProfilePasswordPreviousPasswordBlockCount, workProfilePasswordSignInFailureCountBeforeFactoryReset, workProfilePasswordRequiredType and workProfileRequirePassword properties to the androidForWorkGeneralDeviceConfiguration entity
Change Beta Added the subjectAlternativeNameFormatString property to the androidForWorkPkcsCertificateProfile entity
Change Beta Added the subjectNameFormatString and subjectAlternativeNameFormatString properties to the androidForWorkScepCertificateProfile entity
Change Beta Added the kioskModeManagedApps property to the androidGeneralDeviceConfiguration entity
Change Beta Removed the kioskModeManagedAppId property from the androidGeneralDeviceConfiguration entity
Change Beta Added the subjectAlternativeNameFormatString property to the androidPkcsCertificateProfile entity
Change Beta Added the subjectNameFormatString and subjectAlternativeNameFormatString properties to the androidScepCertificateProfile entity
Change Beta Removed the hexColor property from the calendar entity
Change Beta Added the setting and platformType properties to the complianceSettingStateSummary entity
Change Beta Removed the windowsManagementAppEnabled property from the deviceAppManagement entity
Change Beta Added the userName, deviceModel and platform properties to the deviceComplianceDeviceStatus entity
Change Beta Added the userPrincipalName and deviceModel properties to the deviceComplianceSettingState entity
Change Beta Added the platformType, setting, userId and userEmail properties to the deviceComplianceSettingState entity
Change Beta Added the inGracePeriodCount property to the deviceCompliancePolicyDeviceStateSummary entity
Change Beta Added the userName, deviceModel and platform properties to the deviceConfigurationDeviceStatus entity
Change Beta Removed the creationOptions property from the event entity
Change Beta Removed the isDelegated property from the eventMessage entity
Change Beta Removed the unseenConversationsCount and unseenMessagesCount properties from the group entity
Change Beta Added the settingXml and settings properties to the iosMobileAppConfiguration entity
Change Beta Added the subjectAlternativeNameFormatString property to the iosPkcsCertificateProfile entity
Change Beta Added the subjectAlternativeNameFormatString property to the iosScepCertificateProfile entity
Change Beta Added the systemIntegrityProtectionEnabled property to the macOSCompliancePolicy entity
Change Beta Added the subjectAlternativeNameFormatString property to the macOSScepCertificateProfile entity
Change Beta Added the complianceGracePeriodExpirationDateTime, userPrincipalName. and imei properties to the managedDevice entity
Change Beta Removed the settingXml and settings properties from the managedDeviceMobileAppConfiguration entity
Change Beta Added the useSharedComputerActivation, updateChannel, officePlatformArchitecture and localesToInstall properties to the officeSuiteApp entity
Change Beta Removed the applePushNotificationCertificateSetting property from the organization entity
Change Beta Changed the following properties on the post entity:
sender from optional to required
Change Beta Added the compliantUserCount, nonCompliantUserCount, remediatedUserCount, errorUserCount, unknownUserCount, conflictUserCount and notApplicableUserCount properties to the softwareUpdateStatusSummary entity
Change Beta Added the bluetoothAllowedServices, bluetoothBlockPrePairing, cellularData, defenderDetectedMalwareActions, defenderPotentiallyUnwantedAppAction, lockScreenAllowTimeoutConfiguration, lockScreenBlockCortana, lockScreenBlockToastNotifications, lockScreenTimeoutInSeconds, passwordBlockSimple, privacyAutoAcceptPairingAndConsentPrompts, privacyBlockInputPersonalization, startMenuHideChangeAccountSettings, startMenuHideHibernate, startMenuHideLock, startMenuHideShutDown, startMenuHideSignOut, startMenuHideSleep, startMenuHideSwitchAccount, settingsBlockAppsPage, settingsBlockGamingPage, windowsSpotlightBlockConsumerSpecificFeatures, windowsSpotlightBlocked, windowsSpotlightBlockOnActionCenter, windowsSpotlightBlockTailoredExperiences, windowsSpotlightBlockThirdPartyNotifications, windowsSpotlightBlockWelcomeExperience, windowsSpotlightBlockWindowsTips, windowsSpotlightConfigureOnLockScreen and connectedDevicesServiceBlocked properties to the windows10GeneralConfiguration entity
Change Beta Removed the automaticUpdateMode, automaticUpdateSchedule, automaticUpdateTime, prereleaseFeatures, experienceBlockWindowsSpotlight, experienceBlockWindowsTips and experienceBlockConsumerSpecificFeatures properties from the windows10GeneralConfiguration entity
Change Beta Added the subjectAlternativeNameFormatString property to the windows10PkcsCertificateProfile entity
Change Beta Added the subjectNameFormatString and subjectAlternativeNameFormatString properties to the windows81SCEPCertificateProfile entity
Change Beta Added the indexingEncryptedStoresOrItemsBlocked and smbAutoEncryptedFileExtensions properties to the windowsInformationProtection entity
Change Beta Changed the following properties on the windowsInformationProtection entity:
rightsManagementServicesTemplateId from required to optional
Change Beta Changed the following properties on the windowsMobileMSI entity:
productCode from required to optional
Change Beta Added the subjectNameFormatString and subjectAlternativeNameFormatString properties to the windowsPhone81SCEPCertificateProfile entity
Change Beta Added the mobileAppConfigurations navigation property to the deviceAppManagement entity
Change Beta Added the cartToClassAssociations, deviceCompliancePolicySettingStateSummaries, remoteAssistancePartners, windowsInformationProtectionAppLearningSummaries and windowsMalwareInformation navigation properties to the deviceManagement entity
Change Beta Added the eBook navigation property to the eBookGroupAssignment entity
Change Beta Added the windowsProtectionState navigation property to the managedDevice entity
Change Beta Added the installSummary navigation property to the managedEBook entity
Change Beta Removed the outlook navigation property from the user entity
Change Beta Removed the healthStates navigation property from the windowsManagementApp entity
Change Beta Added the androidForWorkRestrictions property to the defaultDeviceEnrollmentRestrictions complex type
Change Beta Added the userPrincipalName and sources properties to the deviceCompliancePolicySettingState complex type
Change Beta Added the userPrincipalName and sources properties to the deviceConfigurationSettingState complex type
Change Beta Added the settingName, userId, userName, userEmail and currentValue properties to the deviceConfigurationSettingState complex type
Change Beta Removed the archiveFolder property from the mailboxSettings complex type

Outlook calendar

Change type Version Description
Addition v1.0 and beta For findMeetingTimes, added new enum value unrestricted that you specify as the activityDomain property, part of the timeConstraint parameter. This lets findMeetingTimes look for times appropriate for the type of activity you're scheduling for. See details in the request body section.
Addition Beta Support getting an event body in plain text, as an alternative to the default HTML format. See get and list events for details.

Outlook mail

Change type Version Description
Change Beta Support getting a message body in plain text, as an alternative to the default HTML format. See get and list events for details.

Outlook tasks

Change type Version Description
Addition Beta New outlook navigation property added to user, to access Outlook tasks.
Addition Beta New entities - outlookuser, outlookTaskGroup, outlookTaskFolder, and outlookTask - and their methods support organizing and accessing Outlook tasks.
Addition Beta Outlook tasks support attachments (attachment, fileAttachment, itemAttachment, and referenceAttachment resources).
Addition Beta Outlook tasks support extended properties (singleValueLegacyExtendedProperty and multiValueLegacyExtendedProperty resources).

Planner APIs

Change type Version Description
Addition v1.0 Added Planner API.
New resources:
plannerPlan
plannerTask
plannerPlanDetails
plannerTaskDetails
plannerBucket
plannerAssignedToTaskBoardTaskFormat
plannerBucketTaskBoardTaskFormat
plannerProgressTaskBoardTaskFormat

SharePoint sites

Change type Version Description
Addition v1.0 The sites resource is now avaialble in the v1.0 endpoint.
Added the site and siteCollection resource types.
Change beta The format of the identifier for the site resource has changed. This is a breaking change in the beta API.
Removed beta The sharePoint entity has been removed from the beta API. The functionality is now available from the sites collection.

SharePoint Lists

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.

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 15, 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 mention in a message. Mentions support calling out to get the attention of other users in a message.
Addition Beta Added support for the getMailTips action to get any MailTips for specific recipients. Added the following resources: automaticRepliesMailTips, mailTips, mailTipsError.

Query parameters

Change type Version Description
Change Beta Query parameters without $ prefixes are supported as of 09/26/16. The $ prefix in query parameters is optional. For details, see the Supporting query parameters without $ prefixes in Microsoft Graph blog post.

SharePoint

Change type Version Description
Addition Beta Access to SharePoint sites and lists by ID or path/URL.
Addition Beta Support for listing, creating, getting, and deleting instances of listItem.

Users

Change type Version Description
Addition Beta Added refreshTokensValidFromDateTime read-only property to indicate when refresh or session tokens are valid from. Any tokens issued before this time are invalid, and any attempt to use them would force a new sign-in for the user.
Addition Beta Added showInAddressList property to control if the Outlook global address list should contain this user.
Addition Beta Added invalidateAllRefreshTokens service action that invalidates all of the user's refresh and session tokens issued to applications, by resetting the refreshTokensValidFromDateTime user property to the current date-time.

Webhooks

Change type Version Description
Addition Beta Added Drive root items to Webhooks as a resource that is available to subscribe to.

August 2016

Contacts

Change type Version Description
Addition Beta As part of the schema change where a few properties are being removed and corresponding collections are being added to contacts endpoint, the following properties have been added to the contacts endpoint: Websites Collection(ComplexType: Website),Phones Collection (ComplexType: Phone), PostalAddress Collection(ComplexType: PhysicalAddress). For details, see the Upcoming changes to Contacts and People APIs blog post.
Deletion Beta As part of the schema change where a few properties are being removed and corresponding collections are being added to contacts endpoint, the following properties have been removed from the contacts endpoint: BusinessHomePage,HomePhones, MobilePhone1, BusinessPhones, HomeAddress, BusinessAddress, OtherAddress. For details, see the Upcoming changes to Contacts and People APIs blog post.

Excel APIs

Change type Version Description
Addition v1.0 Excel REST API on Microsoft Graph is generally available. Now you can build rich and deep integrations with Excel workbooks in Office 365. See the Power your apps with the new Excel REST API on the Microsoft Graph blog post for more details.

People

Change type Version Description
Change Beta Property WebSite is renamed to Websites. For details, see Upcoming changes to Contacts and People APIs.

Privileged Identity Management

Change type Version Description
Addition Beta Privileged Identity Management (PIM) REST APIs now are available in the Microsoft Graph beta endpoint. Privileged Identity Management provides just in time activation for privileged Azure AD organizational roles such as Global Administrator, Billing Administrator, and so on. You can use the published APIs to write applications that retrieve and update privileged role assignments, and activate users into roles. For details, see Microsoft Graph: Azure AD Privileged Identity Management Preview APIs available in Beta and Azure AD Privileged Identity Management.

July 2016

Administrative Units

Change type Version Description
Addition Beta Introduced the new Administrative Unites preview API. Administrative units allow organizations to subdivide their Azure Active Directory, and delegate administrative duties to those subdivisions. Subdivisions can represent regions, departments, cost centers, etc. This can now be managed through the Microsoft Graph API.

June 2016

IdentityRiskEvents

Change type Version Description
Addition Beta Introduced the new IdentityRiskEvents preview API. This API works in conjunction with Azure Active Directory Identity Protection. You can use it to query risk events generated by Identity Protection. For more details, see the Introduction of a new preview API to Microsoft Graph: IdentityRiskEvents blog post.

Subscriptions

Change type Version Description
Addition Beta App-only scopes are now supported for mail and contacts subscriptions.

May 2016

Calendar

Change type Version Description
Breaking change Beta Changes to the findMeetingTimes API. For more information, see the Microsoft Graph findMeetingTimes API update blog post. This change took effect May 19, 2016.

Contact

Change type Version Description
Addition v1.0 Added extensions, which is abstract type to support the OData v4 open type openTypeExtension.

Directory

Change type Version Description
Breaking change Beta settingTemplateId is renamed to templateId. This change will take effect May 19th, 2016.

Event

Change type Version Description
Addition v1.0 Added extensions, which is abstract type to support the OData v4 open type openTypeExtension.

EventMessages

Change type Version Description
Addition v1.0 Added inferenceClassification and extensions to eventMessages.
Addition Beta Added responseRequested to eventMessageRequest.

Messages

Change type Version Description
Addition v1.0 Added inferenceClassification and extensions to messages.
Addition Beta Added wellknownname to contactFolder.

Post

Change type Version Description
Addition v1.0 Added extensions, which is abstract type to support the OData v4 open type openTypeExtension.

User

Change type Version Description
Addition v1.0 Added inferenceClassification resource type.
Addition Beta Added timeZone to mailboxsettings.
Addition Beta Added API _findMeetingTimes_to user.

April 2016

General

Change type Version Description
Addition v1.0 and Beta Added support for honoring Accept-Encoding:gzip.
Addition v1.0 Added support for cast segment in expand path. For example, 'https://graph.microsoft.com/v1.0/me/messages?$expand=microsoft.graph.eventMessage/event'.
Addition Beta Added support for PATCH request against structural properties. For example: 'PATCH /me/mailboxSettings'.
Addition Beta Azure Active Directory is now used as a fallback for /beta/users/id/photo requests when Outlook is unable to service the request, for example when the user has no mailbox license or the tenant does not have an Exchange Online subscription. NOTE: this fallback is available for both GET and PATCH.
Addition Beta Added support for cast segment in expand path. For example: 'https://graph.microsoft.com/v1.0/me/messages?$expand=microsoft.graph.eventMessage/event'.

OneDrive

Change type Version Description
Fix v1.0 Fixed the issue that OneDrive createLink requests failing with 500 and "Unsupported extension property type."

March 2016

Calendar

Change type Version Description
Addition Beta Added singleValueExtendedProperties and multiValueExtendedProperties properties.
Addition Beta Added suggestionHint property to meetingTimeCandidate.
Addition Beta Added locationUri property to location.
Addition Beta Added type and postOfficeBox to physicalAddress.
Change Beta findMeetingTimes now takes new parameter ReturnSuggestionHints.
Change Beta findMeetingTimes now returns a collection of meetingTimeCandidate.

Drive

Change type Version Description
Addition v1.0 and beta Added recent function to list a set of items that have been recently used by the signed in user. This list includes items that are in the user's drive as well as items they have access tofrom other drives. Example: GET /me/drive/recent.
Addition v1.0 and beta Added sharedWithMe function to list the set of items that are shared with the current user. Example: GET /me/drive/sharedWithMe.

DriveItem

Change type Version Description
Addition v1.0 and beta Added remoteItem type to provide a link to an item in another drive.
Addition v1.0 and beta Added sharingInvitation type to provide details of any associated sharing invitation for this permission.
Addition v1.0 and beta Added delta function to track changes to items in a drive. Example: GET /me/drive/items/{item-id}/delta
Addition v1.0 and beta Added copy that creates a copy of a driveItem (including any children), under a new parent or with a new name. Example: POST /me/drive/items/{item-id}/copy.
Addition v1.0 and beta conflictBehavior instance attributes is now applicable to driveItem.
Addition Beta Added invite function to send a sharing invitation to an existing item. A sharing invitation creates a unique sharing link and sends an email to the recipient of the invitation that includes the sharing link. Example: POST /drive/items/{item-id}/invite.

Event

Change type Version Description
Addition Beta Added new property onlineMeetingUrl and new method cancel.

Event messages

Change type Version Description
Addition Beta Added startDateTime, endDateTime, location, type, recurrence, isOutOfDate, conversationIndex, unsubscribe, unsubscribeData, unsubscribeEnabled and flag properties to eventmessage object.
Addition Beta Added singleValueExtendedProperties and multiValueExtendedProperties properties.
Addition Beta Added new method unsubscribe.

Excel

Change type Version Description
Addition Beta We are adding new Excel REST APIs that let you read and modify data in an Excel workbook. It is now possible to build smart apps that allows users to get value out of the content stored in an Excel workbook by providing insights into the data. Take advantage of analytical powers of Excel, create tables and charts and extract visually appealing chart image - all from within your app. For details, see Working with Excel in Microsoft Graph.

General

Change type Version Description
Addition v1.0 and beta Improved error message when resolving tenant alias and rejected JWT (AAD) tokens.
Addition v1.0 and beta The location of the authorization service endpoint is now returned in the www-authenticate header when a request is received with an empty bearer token.
Addition v1.0 and beta The ability to filter on an entity's id property is now fixed. Example: GET https://graph.microsoft.com/v1.0/users?$filter=id+eq+'x'
Previously, any POST requests to service actions and functions require prefixing the action or function name with the microsoft.graph prefix. For example: POST https://graph.microsoft.com/v1.0/me/Microsoft.Graph.getMemberGroups.
The prefix is now no longer required (although it can still be specified). So the following would now also work: POST https://graph.microsoft.com/v1.0/me/getMemberGroups.
Change Beta Cleaned up subscription property names.
Addition Beta We've added the capability to discover (through directorySettingTemplates) and override the default behavior (by creating a setting from the template) for entities and their associated functionality. Initially this only template provided is to control behaviors on Office groups.

Mail folder

Change type Version Description
Addition Beta Added wellKnownName and userConfigurations properties.
Addition Beta Added singleValueExtendedProperties and multiValueExtendedProperties properties

Messages

Change type Version Description
Addition v1.0 Added mobilePhone property.
Addition v1.0 and beta Added internetMessageId property. The message ID in the format specified by RFC2822.
Change Beta Renamed mobilePhone1 property to mobilePhone.
Change Beta createReply and _createReplyAll_take new parameter Message and comment.
Change Beta createForward takes new parameter Message, ToRecipients and comment.
Change Beta reply, replyAll and forward take new parameter Message.

Permission

Change type Version Description
Addition v1.0 and beta Added sharingInvitation property to provide details of any associated sharing invitation for this permission.

Person

Change type Version Description
Addition Beta Added new properties birthday, personNotes, isFavorite, phones, permission, postalAddresses,websites,yomiCompany, department, profession, mailboxType and personType.
Addition Beta Added new enum types physicalAddressType, webSite, phone and webSiteType.

Reference attachment

Change type Version Description
Addition Beta Added new properties sourceUrl, providerType, thumbnailUrl, previewUrl, permission and isFolder.
Addition Beta Added singleValueExtendedProperties and multiValueExtendedProperties properties.
Addition Beta Added new enum types referenceAttachmentProvider and referenceAttachmentPermission.

Subscriptions

Change type Endpoint Description
Addition v1.0 Webhooks are now GA on v1.0 endpoint via the /Subscriptions resource. Create, Read, Renew and Delete subscriptions to receive notifications on data from Outlook and Office 365 group conversations.

User

Change type Version Description
Addition Beta Added mailboxSettings property and corresponding types.

February 2016

DriveItem

Change type Version Description
Addition v1.0 and beta New remoteItem property on driveItem for Microsoft accounts.

General

Change type Version Description
Change v1.0 and beta -/me/drive now works for both Microsoft accounts and Work and School accounts.
Change v1.0 and beta Drive requests for accounts whose OneDrive storage was provisioned on demand work more reliably and work in more scenarios where tenant default SharePoint sites use non-standard names.
Deletion Beta Removed various unimplemented types from the beta schema to more closely match the 1.0 schema.

Subscriptions

Change type Version Description
Addition Beta notificationUrl validation on subscription creation. For details, see Microsoft Graph WebHooks Update - January 2016.
Addition Beta Subscription entities can now be deleted: DELETE https://graph.microsoft.com/beta/subscriptions/

Users

Change type Version Description
Change v1.0 and beta displayName is now returned for Microsoft accounts.

January 2016

Contacts

Change type Version Description
Addition v1.0 Added mobilePhone property to personal contacts entity-set.

directoryObjects

Change type Version Description
Fix v1.0 and beta Fixed calling actions that are bound to directoryObjects, which were failing with the following error: The return type from the operation is not possible with the given entity set. This applies to the following actions: microsoft.graph.checkMemberObjects, microsoft.graph.getMemberObjects, microsoft.graph.checkMemberGroups, microsoft.graph.assignLicense, microsoft.graph.changePassword.

December 2015

Contacts

Change type Version Description
Addition Beta Added mobilePhone property to personal contacts entity-set.

General

Change type Version Description
Fix v1.0 and beta Fixed requests using $filter expressions that specified the same property more than once, which were failing with the following 500 error: An item with the same key has already been added.
Fix v1.0 and beta Fixed case insensitivity for action parameter names and values.
Fix v1.0 and beta Fixed request processing for payloads containing null values for some embedded complex properties, which were failing with a null reference exception.
Addition v1.0 and beta Added support for complex type property sorting and filtering.
Addition v1.0 and beta Added authorization_uri property in the www-authenticate header on a 401 response. This uri can be used to start the token acquisition flow.
Addition v1.0 and beta Improved error messages across users and groups.

Groups

Change type Version Description
Fix v1.0 and beta Fixed calling the following group actions: microsoft.graph.addFavorite, microsoft.graph.removeFavorite and microsoft.graph.resetUnseenCount.

Messages

Change type Version Description
Addition Beta Added eventMessageRequest subtype of eventMessage and startDateTime, endDateTime, location, type, recurrence and isOutOfDate properties to eventMessage type.

Users

Change type Version Description
Fix v1.0 and beta Fixed being able to select certain user properties on other users, when referencing the user by user principal name (UPN). For example: https://graph.microsoft.com/v1.0/users/anotherUser@contoso.com?$select=aboutMe
Fix v1.0 and beta Fixed calling the microsoft.graph.reminderView user bound function, which was failing with the following error: Could not find a property named businessPhones on type Microsoft.OutlookServices.Reminder.
Fix v1.0 and beta Fixed user creation and update (POST/PATCH /v1.0/users), which was failing with a 400 error.