Changelog for Microsoft Graph

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

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

November 2019

Calendar | Place

Change type Version Description
Addition Beta Added the ability to update a room or roomlist.

Devices and apps (Microsoft Intune)

Change type Version Description
Addition beta Added new entities:
complianceManagementPartner
macOSCustomAppConfiguration
macOSWiredNetworkConfiguration
Addition beta Added new complex types:
companyPortalBlockedAction
complianceManagementPartnerAssignment
deviceManagementPartnerAssignment
roleScopeTagInfo
rotateBitLockerKeysDeviceActionResult
Addition beta Added new enum types:
companyPortalAction
easServices
managedBrowserType
wiredNetworkInterface
Addition beta Added the updateDeviceProperties action on windowsAutopilotDeviceIdentity
Addition beta Added the updateDefinitionValues action on groupPolicyConfiguration
Addition beta Added the getPolicyNonComplianceMetadata action on deviceManagementReports
Deletion beta Removed the following complex types:
scopeTagInfo
Deletion beta Removed the getDeviceNoncomplianceReports action on deviceManagementReports
Deletion beta Removed the getPolicyNoncomplianceReports action on deviceManagementReports
Change beta Changed the following properties on the androidDeviceOwnerCertificateProfileBase entity:
subjectAlternativeNameType from required to optional
Addition beta Added the googleAccountsBlocked property to the androidDeviceOwnerGeneralDeviceConfiguration entity
Addition beta Added the keyboardsRestricted and approvedKeyboards properties to the androidManagedAppProtection entity
Addition beta Added the thirdPartyKeyboardsBlocked property to the defaultManagedAppProtection entity
Addition beta Added the roleScopeTagIds property to the deviceCategory entity
Deletion beta Removed the orderBy property from the deviceManagementExportJob entity
Addition beta Added the groupsRequiringPartnerEnrollment property to the deviceManagementPartner entity
Addition beta Added the roleScopeTagIds property to the groupPolicyConfiguration entity
Addition beta Added the companyPortalBlockedActions, showAzureADEnterpriseApps and showOfficeWebApps properties to the intuneBrandingProfile entity
Addition beta Added the easServices and easServicesUserOverrideEnabled properties to the iosEasEmailProfileConfiguration entity
Deletion beta Removed the siriDisableServerLogging property from the iosGeneralDeviceConfiguration entity
Addition beta Added the thirdPartyKeyboardsBlocked property to the iosManagedAppProtection entity
Addition beta Added the managedBrowser property to the managedAppProtection entity
Addition beta Added the ethernetMacAddress property to the managedDevice entity
Addition beta Added the displayName property to the windowsAutopilotDeviceIdentity entity
Addition beta Added the managedDeviceCertificateStates navigation property to the androidWorkProfilePkcsCertificateProfile entity
Change beta Changed the type of the following properties on the deviceHealthScript entity:
assignments from deviceManagementScriptAssignment collection to deviceHealthScriptAssignment collection
Addition beta Added the complianceManagementPartners navigation property to the deviceManagement entity
Addition beta Added the userRoleScopeTags property to the auditActor complex type
Deletion beta Removed the scopeTags property from the auditActor complex type
Change beta Changed the following properties on the credentialSingleSignOnExtension complex type:
teamIdentifier from required to optional
Addition beta Added the companyPortalBlockedActions, showAzureADEnterpriseApps and showOfficeWebApps properties to the intuneBrand complex type

Education

Change type Version Description
Addition beta Added the classSettings property to the team resource to allow callers to get settings specific to a team of type Class.

Identity and access (Azure AD)

Change type Version Description
Addition v1.0 Added new entity type: application.
Addition v1.0 Added new delegated permissions Application.Read.All, Application.ReadWrite.All.
Addition v1.0 Added new application permission Application.Read.All.
Addition v1.0 Added new delegated and application permissions GroupMember.Read.All and GroupMember.ReadWrite.All to get and update the group API resource.
Addition v1.0 Added new application permission Group.Create to create the group API resource.
Addition beta and v1.0 Added the creationType property to the user resource.

People and workplace intelligence

Change type Version Description
Addition Beta Added the profile API and associated methods.

Microsoft Search is now exposing a way to search and index data in Microsoft Graph.

Change type Version Description
Addition beta Added the Microsoft Search API that constitutes querying and indexing capabilities.
Addition beta Added the query action.
Addition beta Added the searchRequest, searchQuery, searchQueryString,searchResponse, searchHitsContainer, and searchHit complex types.
Addition beta Added the externalConnection, schema, externalItem, and externalFile entities, and methods exposed by these entities.

October 2019

Calendar

Change type Version Description
Addition Beta Added the allowNewTimeProposals property to the event and eventMessageRequest entities.
Addition Beta Added the proposedNewTime optional parameter to the tentativelyAccept and decline methods of event.
Addition Beta Added the eventMessageResponse entity that is based on eventMessage, and in addition, includes the proposedNewTime and responseType properties.
Addition Beta Added the proposedNewTime property to the attendee complex type.
Addition Beta Added new entity calendarPermission.
Addition Beta Added get, update and delete APIs to manage calendarPermission resources on calendar.
Addition Beta Added new complex type onlineMeetingInfo.
Addition Beta Added the isOnlineMeeting, onlineMeetingProvider and onlineMeeting properties to the event entity. isOnlineMeeting and onlineMeetingProvider are optional parameters to the create and update methods of event.
Addition Beta Added the defaultOnlineMeetingProviders and allowedOnlineMeetingProviders properties to the calendar entity.
Addition Beta Added the isTallyingResponses property to the calendar entity.
Addition Beta Added the isRemovable property to the calendar entity.
Addition Beta Added the delegateMeetingMessageDeliveryOptions property to the mailboxSettings entity.

Devices and apps (Microsoft Intune)

Change type Version Description
Addition beta Added new entities:
deviceHealthScriptAssignment
deviceHealthScriptDeviceState
deviceHealthScriptRunSummary
deviceManagementCachedReportConfiguration
deviceManagementExportJob
deviceManagementReports
deviceManagementReportSchedule
groupPolicyMigrationReport
groupPolicySettingMapping
macOSMicrosoftEdgeApp
macOSPkcsCertificateProfile
userExperienceAnalyticsDevicePerformance
userExperienceAnalyticsDeviceStartupHistory
userExperienceAnalyticsRegressionSummary
windowsDefenderApplicationControlSupplementalPolicy
windowsDefenderApplicationControlSupplementalPolicyAssignment
windowsDefenderApplicationControlSupplementalPolicyDeploymentStatus
windowsDefenderApplicationControlSupplementalPolicyDeploymentSummary
windowsMicrosoftEdgeApp
Addition beta Added new complex types:
androidDeviceOwnerGlobalProxy
androidDeviceOwnerGlobalProxyAutoConfig
androidDeviceOwnerGlobalProxyDirect
groupPolicyObjectFile
mobileAppInstallTimeSettings
scopeTagInfo
win32LobAppRestartSettings
Addition beta Added new enum types:
deviceManagementReportFileFormat
deviceManagementReportStatus
deviceManagementScheduledReportRecurrence
diskType
groupPolicyMigrationReadiness
groupPolicySettingScope
groupPolicySettingType
managedAppDeviceThreatLevel
microsoftEdgeChannel
remediationState
userExperienceAnalyticsSummarizedBy
win32LobAppRestartBehavior
windowsDefenderApplicationControlSupplementalPolicyStatuses
Addition beta Added the approveApps action on androidManagedStoreAccountEnterpriseSettings
Addition beta Added the executeAction action on managedDevice collection
Addition beta Added the assign action on deviceHealthScript
Addition beta Added the createMigrationReport) action on groupPolicyMigrationReport collection
Addition beta Added the getDeviceNoncomplianceReports action on deviceManagementReports
Addition beta Added the getPolicyNoncomplianceReports action on deviceManagementReports
Addition beta Added the getDeviceNonComplianceReport action on deviceManagementReports
Addition beta Added the getPolicyNonComplianceReport action on deviceManagementReports
Addition beta Added the getHistoricalReport action on deviceManagementReports
Addition beta Added the getCachedReport action on deviceManagementReports
Addition beta Added the assign action on windowsDefenderApplicationControlSupplementalPolicy
Addition beta Added the summarizeDevicePerformanceDevices function on userExperienceAnalyticsDevicePerformance collection
Addition beta Added the summarizeDeviceRegressionPerformance function on userExperienceAnalyticsRegressionSummary
Deletion beta Removed the following complex types:
deviceHealthScriptComplianceRule
Deletion beta Removed the following enum types:
deviceHealthScriptComplianceRuleOperator
deviceHealthScriptDetectionType
Deletion beta Removed the executeAction action on managedDevice collection
Addition beta Added the globalProxy property to the androidDeviceOwnerGeneralDeviceConfiguration entity
Addition beta Added the workProfileBlockPersonalAppInstallsFromUnknownSources property to the androidForWorkGeneralDeviceConfiguration entity
Addition beta Added the minimumRequiredCompanyPortalVersion, minimumWarningCompanyPortalVersion and minimumWipeCompanyPortalVersion properties to the androidManagedAppProtection entity
Addition beta Added the workProfileBlockPersonalAppInstallsFromUnknownSources property to the androidWorkProfileGeneralDeviceConfiguration entity
Addition beta Added the remediation property to the appVulnerabilityTask entity
Addition beta Added the minimumRequiredCompanyPortalVersion, minimumWarningCompanyPortalVersion and minimumWipeCompanyPortalVersion properties to the defaultManagedAppProtection entity
Addition beta Added the configurationWebUrl property to the depEnrollmentBaseProfile entity
Addition beta Added the source and sourceId properties to the deviceCompliancePolicyAssignment entity
Addition beta Added the publisher, version, displayName, description, detectionScriptContent, createdDateTime, lastModifiedDateTime, runAsAccount, enforceSignatureCheck, runAs32Bit and roleScopeTagIds properties to the deviceHealthScript entity
Deletion beta Removed the complianceRule property from the deviceHealthScript entity
Addition beta Added the groupPolicyObjectFiles property to the deviceManagement entity
Deletion beta Removed the runSchedule property from the deviceManagementScript entity
Deletion beta Removed the lastSyncDateTime, preRemediationDetectionScriptOutput, remediationScriptError and postRemediationDetectionScriptOutput properties from the deviceManagementScriptDeviceState entity
Deletion beta Removed the compliantDeviceCount, notCompliantDeviceCount and pendingDeviceCount properties from the deviceManagementScriptRunSummary entity
Addition beta Added the platformType property to the deviceManagementTemplate entity
Addition beta Added the source and sourceId properties to the enrollmentConfigurationAssignment entity
Addition beta Added the mdmAppId and securityIdentifier properties to the group entity
Addition beta Added the isDeleted property to the importedAppleDeviceIdentity entity
Addition beta Added the filesNetworkDriveAccessBlocked, filesUsbDriveAccessBlocked and wifiPowerOnForced properties to the iosGeneralDeviceConfiguration entity
Deletion beta Removed the wiFiBlockPowerModification property from the iosGeneralDeviceConfiguration entity
Addition beta Added the previousPinBlockCount, maximumAllowedDeviceThreatLevel and mobileThreatDefenseRemediationAction properties to the managedAppProtection entity
Addition beta Added the source and sourceId properties to the mobileAppAssignment entity
Addition beta Added the androidMobileApplicationManagementEnabled and iosMobileApplicationManagementEnabled properties to the mobileThreatDefenseConnector entity
Change beta Changed the following properties on the windows10GeneralConfiguration entity:
energySaverOnBatteryThresholdPercentage from required to optional
energySaverPluggedInThresholdPercentage from required to optional
Addition beta Added the source and sourceId properties to the windowsAutopilotDeploymentProfileAssignment entity
Addition beta Added the filesFolder navigation property to the channel entity
Addition beta Added the wdacSupplementalPolicies navigation property to the deviceAppManagement entity
Addition beta Added the assignments, runSummary and deviceRunStates navigation properties to the deviceHealthScript entity
Addition beta Added the deviceHealthScripts, userExperienceAnalyticsDevicePerformance, userExperienceAnalyticsRegressionSummary, userExperienceAnalyticsDeviceStartupHistory, groupPolicyMigrationReports and reports navigation properties to the deviceManagement entity
Addition beta Added the singleSignOnExtensionPkinitCertificate navigation property to the iosDeviceFeaturesConfiguration entity
Addition beta Added the singleSignOnExtensionPkinitCertificate navigation property to the macOSDeviceFeaturesConfiguration entity
Addition beta Added the scopeTags property to the auditActor complex type
Addition beta Added the androidDedicatedCount, androidDeviceAdminCount, androidFullyManagedCount and androidWorkProfileCount properties to the deviceOperatingSystemSummary complex type
Addition beta Added the restartSettings and installTimeSettings properties to the win32LobAppAssignmentSettings complex type
Addition beta Added the deviceRestartBehavior property to the win32LobAppInstallExperience complex type
Addition beta Added the customPassword member to the androidDeviceOwnerRequiredPasswordType enum type
Deletion beta Removed the appleUserEnrollmentWithAzureAD member from the deviceEnrollmentType enum type
Addition beta Added the microsoftEdgeSecurityBaseline and microsoftOffice365ProPlusSecurityBaseline members to the deviceManagementTemplateType enum type
Addition beta Added the setDeviceName member to the managedDeviceRemoteAction enum type
Addition beta Added the scriptError and notApplicable members to the runState enum type
Deletion beta Removed the error member from the runState enum type
Addition beta Added the userExperienceAnalytics member to the windowsHealthMonitoringScope enum type

Education

Change type Version Description
Deletion beta Removed previously announced deprecated properties grade and feedback from educationSubmission. Access grades and feedback only through educationOutcome.

Groups

Change type Version Description
Addition Beta Added the hideFromAddressLists and hideFromOutlookClients properties to the group entity, to control the visibility of a group in the Outlook user interface.
Addition Beta Added the assignLicense method which can be used to add or remove licenses on users in a group.

Identity and access (Azure AD)

Change type Version Description
Addition Beta Added new entities:
authenticationDetail
keyValue
networkLocationDetail
Addition Beta Added the alternateSignInName, ServicePrincipalId, ServicePrincipalName, and authenticationProcessingDetails properties to the signIn resource.
Deletion Beta Moved the reference to mfaDetail from signIn to authenticationDetail.
Addition Beta Added the signInActivity property to the user resource.
Addition Beta Added a new entity type: Trustframeworkkeyset
Addition Beta Added new entity type: Identityuserflow
Addition Beta Added new entitlement management resources.
Addition Beta Added removePassword method to the application resource.
Addition Beta Added addIns property to the application.
Addition Beta Added addPassword and removePassword methods to the serviceprincipal resource.
Addition Beta and v1.0 Added the onPremisesDomainName, onPremisesNetBiosName, and onPremisesSamAccountName properties to the group entity.
Addition Beta and v1.0 Added the securityIdentifier property to the group resource.
Addition Beta and v1.0 Added the mdmAppId property to the device resource.
Addition Beta and v1.0 Added the manufacturer and model properties to the device entity.
Addition v1.0 Added new orgContact resource. These contacts are managed by the organization, and are different from personal contacts
Addition v1.0 Added new physicalOfficeAddress resource.
Addition v1.0 Added new entity certificateBasedAuthConfiguration.
Addition v1.0 Added new complex type certificateAuthority.
Addition v1.0 Added new relationship for certificateBasedAuthConfiguration on the organization resource. This enables certificate-based authentication in Azure Active Directory.

Identity and access (Azure AD) | Conditional access

Change type Version Description
Addition Beta Added new entity types:
conditionalAccessPolicy
Addition Beta Added new complex types:
conditionalAccessSessionControl
applicationEnforcedRestrictionsSessionControl
cloudAppSecuritySessionControl
signInFrequencySessionControl
persistentBrowserSessionControl
conditionalAccessSessionControls
conditionalAccessApplications
conditionalAccessUsers
conditionalAccessPlatforms
conditionalAccessLocations
conditionalAccessDeviceStates
conditionalAccessConditionSet
conditionalAccessGrantControls
Addition Beta Added the namedLocation API, which represents named locations in Azure AD conditional access.

Identity and access | Information protection

Change type Version Description
Change beta Changed detectedSensitiveContent entity name to classificationResult.
Deletion beta Removed displayName, uniqueCount, and matches properties from classificationResult.
Change beta Changed id to sensitiveTypeId properties of classificationResult.
Change beta Changed confidence to confidenceLevel property of classificationResult.
Addition beta Added count property to classificationResult/.
Deletion beta Removed actionSource property from labelingOptions.
Deletion beta Removed auditInfo entity.
Change beta Changed protectByDoNotForwardAction to protectDoNotForwardAction.
Addition beta Added alignment property to addContentHeaderAction.
Change beta Changed labelId property to label in recommendLabelAction.
Change beta Changed classificationIds property to responsibleSensitivityTypeIds in recommendLabelAction.
Addition beta Added actionSource property to recommendLabelAction.
Change beta Changed labelId property to label in applyLabelAction.
Change beta Changed classificationIds property to responsibleSensitivityTypeIds in applyLabelAction.
Addition beta Added actionSource property to applyLabelAction.
Change beta Change contentFormat) enum value file to default.
Deletion beta Removed mandatory value from actionSource) enum.
Change beta Removed actionSource) enum value policyDefault to default.
Deletion beta Removed auditMetadataKey.
Change beta Change applyLabel API to evaluateApplication.
Change beta Change applyLabelFromClassification API to evaluateClassificationResults.
Change beta Change removeLabel API to evaluateRemoval.
Deletion beta Removed auditInfo from extractLabel.

Mail (Outlook)

Change type Version Description
Addition Beta Adding file attachments up to 150MB to a message instance.
Addition Beta The attachmentItem complex type, createUploadSession action for the attachment entity, and the attachmentType enumeration.
Changed Beta Extended the existing uploadSession entity that has been used by driveItem to apply to attachment as well.
Addition v1.0 Added the message parameter to the method for replying a message on the fly.

Notifications

Change type Version Description
Addition Beta Added the Create and send notifications API to enable targeting users without managing the on-behalf-of tokens.
Addition Beta Introduced the targetPolicy property on the notification resource to enable web endpoints to be targeted via webpush.
Addition Beta Added the fallbackPolicy property on the notification resource to enable guaranteed delivery on iOS for high-priority notifications.

Teamwork (Microsoft Teams)

Change type Version Description
Addition Beta Added the Get team photo and Update team photo methods.
Addition Beta Reading images in messages now support application permissions.

Users

Change type Version Description
Addition v1.0 Added the new lastPasswordChangeDateTime property to the user resource.
Addition beta Added the user: reprocessLicenseAssignment API, which can be used to reprocess all group-based license assignments for the user.

Users | Outlook settings

Change type Version Description
Addition V1.0 The dateFormat and timeFormat properties to the mailboxSettings resource. The properties represent the user's preferred date and time formats.

September 2019

Calendar, mail, groups

Change type Version Description
Addition v1.0 Added the capability to get the raw contents of a file or item attachment to an event, message, or group post.

Devices and apps (Microsoft Intune)

Change type Version Description
Addition beta Added new entities:
androidDeviceOwnerScepCertificateProfile
androidManagedStoreWebApp
appleEnrollmentProfileAssignment
appleUserInitiatedEnrollmentProfile
deviceCompliancePolicyPolicySetItem
deviceConfigurationPolicySetItem
deviceManagementAutopilotEvent
deviceManagementScriptPolicySetItem
enrollmentRestrictionsConfigurationPolicySetItem
iosLobAppProvisioningConfigurationPolicySetItem
macManagedAppProtection
managedAppProtectionPolicySetItem
managedDeviceMobileAppConfigurationPolicySetItem
mdmWindowsInformationProtectionPolicyPolicySetItem
mobileAppPolicySetItem
policySet
policySetAssignment
policySetItem
targetedManagedAppConfigurationPolicySetItem
windows10EnrollmentCompletionPageConfigurationPolicySetItem
windowsAutopilotDeploymentProfilePolicySetItem
windowsFeatureUpdateProfile
windowsFeatureUpdateProfileAssignment
Addition beta Added new complex types:
appleOwnerTypeEnrollmentType
configurationManagerAction
credentialSingleSignOnExtension
hasPayloadLinkResultItem
iosKerberosSingleSignOnExtension
kerberosSingleSignOnExtension
keyBooleanValuePair
keyIntegerValuePair
keyRealValuePair
keyStringValuePair
keyTypedValuePair
macOSKerberosSingleSignOnExtension
singleSignOnExtension
Addition beta Added new enum types:
appleUserInitiatedEnrollmentType
bitLockerRecoveryPasswordRotationType
configurationManagerActionType
deviceAndAppManagementAssignmentSource
errorCode
logLevel
policySetStatus
userExperienceAnalyticsHealthState
userExperienceAnalyticsInsightSeverity
windowsAutopilotDeploymentState
windowsAutopilotEnrollmentType
Addition beta Added the update action on policySet
Addition beta Added the hasPayloadLinks action on mobileApp collection
Addition beta Added the hasPayloadLinks action on targetedManagedAppConfiguration collection
Addition beta Added the hasPayloadLinks action on iosManagedAppProtection collection
Addition beta Added the hasPayloadLinks action on androidManagedAppProtection collection
Addition beta Added the hasPayloadLinks action on macManagedAppProtection collection
Addition beta Added the hasPayloadLinks action on mdmWindowsInformationProtectionPolicy collection
Addition beta Added the hasPayloadLinks action on iosLobAppProvisioningConfiguration collection
Addition beta Added the getPolicySets action on policySet collection
Addition beta Added the hasPayloadLinks action on deviceManagementScript collection
Addition beta Added the hasPayloadLinks action on deviceConfiguration collection
Addition beta Added the hasPayloadLinks action on deviceCompliancePolicy collection
Addition beta Added the hasPayloadLinks action on windowsAutopilotDeploymentProfile collection
Addition beta Added the hasPayloadLinks action on deviceEnrollmentConfiguration collection
Addition beta Added the triggerConfigurationManagerAction action on managedDevice
Addition beta Added the setPriority action on appleUserInitiatedEnrollmentProfile
Addition beta Added the assign action on windowsFeatureUpdateProfile
Addition beta Added the getExpiringVppTokenCount function on depOnboardingSetting collection
Addition beta Added the deviceThreatProtectionEnabled, deviceThreatProtectionRequiredSecurityLevel, securityRequireSafetyNetAttestationBasicIntegrity and securityRequireSafetyNetAttestationCertifiedDevice properties to the androidDeviceOwnerCompliancePolicy entity
Addition beta Added the workProfileAllowWidgets property to the androidForWorkGeneralDeviceConfiguration entity
Addition beta Added the isPrivate and isSystemApp properties to the androidManagedStoreApp entity
Addition beta Added the workProfileAllowWidgets property to the androidWorkProfileGeneralDeviceConfiguration entity
Addition beta Added the screenTimeScreenDisabled property to the depEnrollmentBaseProfile entity
Addition beta Added the appearanceScreenDisabled, expressLanguageScreenDisabled, preferredLanguageScreenDisabled, deviceToDeviceMigrationDisabled and welcomeScreenDisabled properties to the depIOSEnrollmentProfile entity
Deletion beta Removed the screenTimeScreenDisabled property from the depIOSEnrollmentProfile entity
Addition beta Added the source and sourceId properties to the deviceConfigurationAssignment entity
Deletion beta Removed the runRemediationScript property from the deviceHealthScript entity
Addition beta Added the singleSignOnExtension property to the iosDeviceFeaturesConfiguration entity
Addition beta Added the kioskModeEnableVoiceControl and kioskModeAllowVoiceControlModification properties to the iosGeneralDeviceConfiguration entity
Addition beta Added the associatedDomains and singleSignOnExtension properties to the macOSDeviceFeaturesConfiguration entity
Addition beta Added the source and sourceId properties to the targetedManagedAppPolicyAssignment entity
Addition beta Added the roleScopeTagIds property to the termsAndConditions entity
Addition beta Added the isBuiltIn and createdDateTime properties to the userExperienceAnalyticsBaseline entity
Deletion beta Removed the overallScore and overallRegressionThreshold properties from the userExperienceAnalyticsBaseline entity
Deletion beta Removed the displayName and overallScore properties from the userExperienceAnalyticsCategory entity
Deletion beta Removed the displayName property from the userExperienceAnalyticsMetric entity
Deletion beta Removed the overallScore, deviceBootPerformanceOverallScore and bestPracticesOverallScore properties from the userExperienceAnalyticsOverview entity
Addition beta Added the attackSurfaceReductionRules and bitLockerRecoveryPasswordRotation properties to the windows10EndpointProtectionConfiguration entity
Addition beta Added the trackInstallProgressForAutopilotOnly and disableUserStatusTrackingAfterFirstUser properties to the windows10EnrollmentCompletionPageConfiguration entity
Addition beta Added the policySets navigation property to the deviceAppManagement entity
Addition beta Added the appleUserInitiatedEnrollmentProfiles, autopilotEvents and windowsFeatureUpdateProfiles navigation properties to the deviceManagement entity
Addition beta Added the value property to the insightValueDouble complex type
Addition beta Added the value property to the insightValueInt complex type
Addition beta Added the v13_0 property to the iosMinimumOperatingSystem complex type
Addition beta Added the v10_14 and v10_15 properties to the macOSMinimumOperatingSystem complex type
Addition beta Added the values and severity properties to the userExperienceAnalyticsInsight complex type
Deletion beta Removed the value property from the userExperienceAnalyticsInsight complex type
Addition beta Added the appleUserEnrollment, appleUserEnrollmentWithServiceAccount and appleUserEnrollmentWithAzureAD members to the deviceEnrollmentType enum type
Addition beta Added the securityTemplate member to the deviceManagementTemplateType enum type
Addition beta Added the rebootNow member to the managedDeviceRemoteAction enum type
Addition beta Added the rotateBitLockerKeys member to the remoteAction enum type
Addition Beta Added application permissions support for write operations: DeviceManagementConfiguration.ReadWrite.All, DeviceManagementApps.ReadWrite.All, DeviceManagementManagedDevices.ReadWrite.All, DeviceManagementRBAC.ReadWrite.All, DeviceManagementServiceConfig.ReadWrite.All
Addition v1.0 Added the v13_0 property to the iosMinimumOperatingSystem complex type.

Education

Change type Version Description
Addition beta Added new property closeDateTime to educationAssignment.
Change beta Changed property names mkcd to projectId and url to hostWebUrl in educationMakeCodeResource resource.

Cloud communications (Calls and online meetings)

Change type Version Description
Addition Beta Added /communications/* APIs for all calls and online meetings. The /app path is deprecated. Going forward, use the /communications path.
Removal Beta Deprecated the /app path.
Deletion Beta Removed the properties createdDateTime and lastActionDateTime from the commsOperation resource.
Deletion Beta Removed the property meetingType from the onlineMeeting resource.
Addition Beta Added the property isBroadcast to the onlineMeeting resource.
Change Beta Renamed the resource property to resourceUrl on the commsNotification resource.
Change Beta Changed the type of the code and subCode properties from string to Int32 on the resultInfo resource.
Change Beta Renamed the subcode property to subCode on the resultInfo resource.

Files (OneDrive for Business and OneDrive Personal)

Change type Version Description
Addition Beta Added the pendingOperations and pendingContentUpdate resources. The pendingOperations resource applies to the driveItem resource.
Addition Beta Added the restore action to the driveItem resource.
Addition Beta Added the orientation property to the photo resource.
Addition Beta Added the sha256Hash property to the hashes resource.

Identity and access (Azure AD)

Change type Version Description
Addition Beta Added the objectIdentity resource that represents an identity used to sign in to a user account.
Addition Beta Added synchronizationJobSettings property to the synchronizationJob resource.
Addition Beta Added new possible values for the reason property in the synchronizationQuarantine resource.
Addition Beta Added the capability to manage password single sign on credentials on the servicePrincipal object.

Mail (Outlook)

Change type Version Description
Addition v1.0 Added the capability to get the MIME content of a message.

Teamwork (Microsoft Teams)

Change type Version Description
Addition beta Added the primaryChannel property to the team resource.
Addition beta Added the allowCreatePrivateChannels property to the teamMemberSettings resource.

Users

Change type Version Description
Addition Beta Added the identities property to the user resource. This property represents the set of identities that this user can use to sign in with.
Addition v1.0 Added the translateExchangeIds method.

Users | Outlook settings

Change type Version Description
Addition Beta The dateFormat and timeFormat properties to the mailboxSettings resource. The properties represent the user's preferred date and time formats.

August 2019

Devices and apps (Microsoft Intune)

Change type Version Description
Addition beta Added new entities:
androidDeviceOwnerCertificateProfileBase
androidDeviceOwnerEnterpriseWiFiConfiguration
androidDeviceOwnerTrustedRootCertificate
androidDeviceOwnerVpnConfiguration
deviceHealthScript
userExperienceAnalyticsBaseline
userExperienceAnalyticsCategory
userExperienceAnalyticsMetric
userExperienceAnalyticsOverview
vpnConfiguration
Addition beta Added new complex types:
configurationManagerClientInformation
deviceHealthScriptComplianceRule
insightValueDouble
insightValueInt
userExperienceAnalyticsInsight
userExperienceAnalyticsInsightValue
Addition beta Added new enum types:
androidDeviceOwnerVirtualHomeButtonType
deviceHealthScriptComplianceRuleOperator
deviceHealthScriptDetectionType
powerActionType
Addition beta Added the enableAndroidDeviceAdministratorEnrollment action on deviceManagement
Addition beta Added the executeAction action on managedDevice collection
Addition beta Added the sendCustomNotificationToCompanyPortal action on managedDevice
Deletion beta Removed the executeAction action on managedDevice collection
Addition beta Added the roleScopeTagIds property to the androidDeviceOwnerEnrollmentProfile entity
Deletion beta Removed the scopeTags property from the androidDeviceOwnerEnrollmentProfile entity
Addition beta Added the kioskModeScreenSaverConfigurationEnabled, kioskModeScreenSaverImageUrl, kioskModeScreenSaverDisplayTimeInSeconds, kioskModeScreenSaverStartDelayInSeconds, kioskModeScreenSaverDetectMediaDisabled, kioskModeVirtualHomeButtonType, kioskModeFlashlightConfigurationEnabled and kioskModeMediaVolumeConfigurationEnabled properties to the androidDeviceOwnerGeneralDeviceConfiguration entity
Addition beta Added the lastSyncDateTime, preRemediationDetectionScriptOutput, remediationScriptError and postRemediationDetectionScriptOutput properties to the deviceManagementScriptDeviceState entity
Addition beta Added the compliantDeviceCount, notCompliantDeviceCount and pendingDeviceCount properties to the deviceManagementScriptRunSummary entity
Addition beta Added the isRemoveDeviceDisabled and isFactoryResetDisabled properties to the intuneBrandingProfile entity
Addition beta Added the continuousPathKeyboardBlocked, findMyDeviceInFindMyAppBlocked, findMyFriendsInFindMyAppBlocked, wiFiBlockPowerModification and iTunesBlocked properties to the iosGeneralDeviceConfiguration entity
Addition beta Added the iCloudBlockActivityContinuation property to the macOSGeneralDeviceConfiguration entity
Addition beta Added the configurationManagerClientInformation property to the managedDevice entity
Addition beta Added the managedDeviceId property to the remoteActionAudit entity
Addition beta Added the isBuiltIn property to the roleScopeTag entity
Deletion beta Removed the userRightsRegisterProcessAsService property from the windows10EndpointProtectionConfiguration entity
Addition beta Added the energySaverOnBatteryThresholdPercentage, energySaverPluggedInThresholdPercentage, powerLidCloseActionOnBattery, powerLidCloseActionPluggedIn, powerButtonActionOnBattery, powerButtonActionPluggedIn, powerSleepButtonActionOnBattery, powerSleepButtonActionPluggedIn, powerHybridSleepOnBattery and powerHybridSleepPluggedIn properties to the windows10GeneralConfiguration entity
Addition beta Added the deadlineForFeatureUpdatesInDays, deadlineForQualityUpdatesInDays, deadlineGracePeriodInDays and postponeRebootUntilAfterDeadline properties to the windowsUpdateForBusinessConfiguration entity
Addition beta Added the userExperienceAnalyticsOverview, userExperienceAnalyticsBaselines and userExperienceAnalyticsCategories navigation properties to the deviceManagement entity
Deletion beta Removed the healthSummary navigation property from the windowsManagementApp entity Addition beta Added the shareUserExperienceAnalyticsData property to the adminConsent complex type
Addition beta Added the osBuildNumber property to the hardwareInformation complex type
Addition beta Added the isRemoveDeviceDisabled and isFactoryResetDisabled properties to the intuneBrand complex type
Addition beta Added the uninstallOnDeviceRemoval property to the iosLobAppAssignmentSettings complex type
Addition beta Added the uninstallOnDeviceRemoval property to the iosStoreAppAssignmentSettings complex type
Addition beta Added the uninstallOnDeviceRemoval property to the iosVppAppAssignmentSettings complex type
Addition beta Added the customTextNotification member to the managedDeviceRemoteAction enum type
Addition beta Added the setDeviceName member to the remoteAction enum type
Addition beta Added the error and pending members to the runState enum type
Addition beta Added the noScheduledScan member to the weeklySchedule enum type
Addition beta Added the derivedCredentials navigation property to the deviceManagement entity

Education

Change type Version Description
Addition beta Added new property grade to educationClass.
Addition beta Added the new educationRubric resource.
Addition beta Added APIs to manage educationRubric resources on educationUser and educationAssignment.
Addition beta Added the new educationOutcome resource.
Addition beta Added APIs to manage educationOutcome resources on educationSubmission.
Addition beta Added the new educationMakeCodeResource resource.
Addition beta Added new property grade to educationClass.

Files (OneDrive for Business)

Change type Version Description
Addition Beta Added the unfollow action on driveItem

Identity and access (Azure AD)

Change type Version Description
Change Beta Changed the List provisioningObjectSummary namespace.
Addition Beta Added the roleManagement resource that provides access to role definitions and role assignments surfaced from RBAC providers.
Addition Beta Added the unifiedRoleDefinition resource that represents a collection of permissions listing the operations that can be performed.
Addition Beta Added the unifiedRoleAssignment resource that grants access to resources.
Addition Beta Added these operations to support the unifiedRoleDefinition resource:
Addition Beta Added these operations to support the unifiedRoleAssignment resource:
Addition Beta Added the List accessReviews operation.
Addition Beta Added the checkMemberObjects operation for the device resource.
Addition Beta Added the checkMemberObjects operation for the directoryObject resource.
Addition Beta Added the checkMemberObjects operation for the directoryRole resource.
Addition Beta Added the checkMemberObjects operation for the group resource.
Addition Beta Added the checkMemberObjects operation for the servicePrincipal resource.
Addition Beta Added the checkMemberObjects operation for the user resource.
Addition Beta Added delegated and application permissions for reading organizational contacts: OrgContact.Read.All
Addition beta Added new entity certificateBasedAuthConfiguration.
Addition beta Added new complex type certificateAuthority.
Addition beta Added new relationship for certificateBasedAuthConfiguration on the organization resource. This enables certificate-based authentication in Azure Active Directory

Reports

Change type Version Description
Addition v1.0 Added the deletedItemCount and deletedItemSizeInBytes property to the mailboxUsageDetail entity.
Addition v1.0 Added the groupId property to the office365GroupsActivityDetail entity.
Addition v1.0 Added the ownerPrincipalName property to the oneDriveUsageAccountDetail entity.
Addition v1.0 Added the ownerPrincipalName property to the sharePointSiteUsageDetail entity.
Addition v1.0 Added the office365Active and office365Inactive properties to the office365ServicesUserCounts entity.

Social and workplace intelligence

Change type Version Description
Addition Beta Introduced the new workplace intelligence analytics API that enables you to get analytics about how users spend their time on various activities during and outside of working hours, including calls, chats (instant messages), emails, focus work, and meetings.
Addition Beta Introduced the new workplace intelligence settings API that represents the current required settings for a user to use the analytics API.
Addition Beta Introduced the new activityStatistics resource type and the following new resource types that are derived from it: callActivityStatistics, chatActivityStatistics,emailActivityStatistics, focusActivityStatistics, and meetingActivityStatistics.

Tasks and plans (Planner)

Change type Version Description
Addition Beta Added the priority property to the plannerTask entity.

Teamwork (Microsoft Teams)

Change type Version Description
Addition Beta Added the ability to pull incremental messages from channels with the channel messages delta query API.
Addition Beta Added the ability to add members to a private channel.
Addition Beta Added the ability to remove members from a private channel.
Addition Beta Added the ability to update a member's role in a private channel.
Addition Beta Added the membershipType property to the channel resource to show if a particular channel is private or standard.

July 2019

Calendar | Place

Debut of the places API which provides rich details for locations in apps.

Change type Version Description
Addition Beta Added the room list resource
Addition Beta Added the room resource
Addition Beta Added the place resource
Addition Beta Added delegated and application permissions for the places API: Place.Read.All

Devices and apps (Microsoft Intune)

Change type Version Description
Addition beta Added new entities:
managedAllDeviceCertificateState
Addition beta Added new complex types:
windowsKioskForceUpdateSchedule
Addition beta Added new enum types:
fileVaultState
windowsDefenderTamperProtectionOptions
Addition beta Added the getRoleScopeTagsById action on roleScopeTag collection
Addition beta Added the createInstance action on deviceManagementTemplate
Addition beta Added the hasCustomRoleScopeTag function on roleScopeTag collection
Deletion beta Removed the createInstance action on deviceManagementTemplate
Deletion beta Removed the autopilotDeviceStream function on importedWindowsAutopilotDeviceIdentityUpload
Addition beta Added the scopeTags property to the androidDeviceOwnerEnrollmentProfile entity
Addition beta Added the nestedSchemaItems property to the androidManagedStoreAppConfigurationSchema entity
Addition beta Added the groupTag property to the importedWindowsAutopilotDeviceIdentity entity
Addition beta Added the fileVaultStates property to the managedDeviceEncryptionState entity
Addition beta Added the userRightsDenyLocalLogOn and windowsDefenderTamperProtection properties to the windows10EndpointProtectionConfiguration entity
Addition beta Added the localGuestAccountName and assessmentAppUserModelId properties to the windows10SecureAssessmentConfiguration entity
Addition beta Added the cacheServerHostNames, cacheServerForegroundDownloadFallbackToHttpDelayInSeconds and cacheServerBackgroundDownloadFallbackToHttpDelayInSeconds properties to the windowsDeliveryOptimizationConfiguration entity
Addition beta Added the windowsKioskForceUpdateSchedule property to the windowsKioskConfiguration entity
Addition beta Added the deviceConfigurationsAllManagedDeviceCertificateStates navigation property to the deviceManagement entity
Deletion beta Removed the importedWindowsAutopilotDeviceIdentityUploads navigation property from the deviceManagement entity
Addition beta Added the deviceUpdateStates navigation property to the windowsUpdateForBusinessConfiguration entity
Addition beta Added the index and parentIndex properties to the androidManagedStoreAppConfigurationSchemaItem complex type
Addition beta Added the androidDeviceAdministratorEnrollmentEnabled property to the deviceManagementSettings complex type
Addition beta Added the edgeTraversal property to the windowsFirewallRule complex type
Addition beta Added the localGuestAccount member to the secureAssessmentAccountType enum type
Addition beta Added the empty and clientCertificateSubjectName members to the vpnLocalIdentifier enum type
Addition beta Added the revision property to the groupPolicyDefinitionFile entity
Addition beta Added the valuePrefix property to the groupPolicyPresentationListBox entity

Files (OneDrive for Business)

Change type Version Description
Addition beta Added the expirationDatetime and password properties to the createLink action.

Identity and access (Azure AD)

Change type Version Description
Addition v1.0 Added new delegated and application permissions Organization.Read.All and Organization.ReadWrite.All to get and update the organization API resource and get the subcribedSku resource.
Addition Beta Added new delegated and application permissions Organization.Read.All and Organization.ReadWrite.All to get and update the organization API resource and get the subcribedSku resource.
Addition v1.0 Added the group:validateProperties function and directoryobject:validateProperties function on groups, which validates that an Office 365 group's display name or mail nickname complies with naming policies.
Addition Beta Added 'version', 'discoveryDateTime', 'discoverabilities' properties to resource type directoryDefinition.
Addition Beta Added the directoryDefinition: discover method.
Addition Beta Added new delegated and application permissions AdministrativeUnit.Read.All and AdministrativeUnit.ReadWrite.All to get and update the administrative unit API resource.
Addition v1.0 Added new delegated and application permissions RoleManagement.Read.Directory and RoleManagement.ReadWrite.Directory to get and update the directory role API resource and get the directory role template API resource.
Addition Beta Added new application permission AccessReview.ReadWrite.Membership to get, create, update and delete in the access reviews API.
Addition Beta Added new resource type featureRolloutPolicy to the directory resource. Feature rollout policy helps tenant administrators to pilot features to specific groups before enabling them for entire organization.

Mail (Outlook)

Change type Version Description
Addition beta Added support for the Mail.ReadBasic.All application permission in mailFolder API: list mailfolders, get a mailfolder, list child folders and list messages in a mail folder. Also added Mail.ReadBasic.All support in delta query for message and delta query for mailFolder.

Reports

Change type Version Description
Addition Beta Added deletedItemCount property to the mailboxUsageDetail entity.
Addition Beta Added deletedItemSizeInBytes property to the mailboxUsageDetail entity.
Addition Beta Added groupId property to the office365GroupsActivityDetail entity.

Teamwork (Microsoft Teams)

Change type Version Description
Addition beta Added support for application permissions to List channel messages, Get channel message, List replies to a message, and Get a reply to a message.
Addition beta Added support for application permissions to List messages in a chat and Get message in chat.
Addition beta Added the installedApps property to the chat resource.
Addition beta Added navigation binding for chats property of the user resource.
Addition beta Added the teamwork resource.
Addition beta Added the userTeamwork resource.
Addition beta Added new methods to the user resource enabling the following methods with personal apps for users:
List apps installed for user
Install app for user
Uninstall app for user
Upgrade app installed for user

Calls and online meetings

Change type Version Description
Addition Beta Added mediaState property to call resource
Change Beta Renamed recordResourceLocation property in recordOperation resource to recordingLocation
Change Beta Renamed recordResourceAccessToken property in recordOperation resource to recordingAccessToken
Addition Beta Added capabilities property to onlineMeeting resource
Addition Beta Added videoTeleconferenceId property to onlineMeeting resource
Addition Beta Added producers property to meetingParticipants resource
Addition Beta Added contributors property to meetingParticipants resource

June 2019

Devices and apps (Microsoft Intune)

Change type Version Description
Addition beta Added new entities:
appVulnerabilityManagedDevice
appVulnerabilityMobileApp
appVulnerabilityTask
deviceAppManagementTask
deviceManagementDomainJoinConnector
iosikEv2VpnConfiguration
roleScopeTagAutoAssignment
windows10DeviceFirmwareConfigurationInterface
Addition beta Added new complex types:
deviceManagementApplicabilityRuleDeviceMode
deviceManagementApplicabilityRuleOsEdition
deviceManagementApplicabilityRuleOsVersion
deviceManagementSettingComparison
iosVpnSecurityAssociationParameters
Addition beta Added new enum types:
appInstallControlType
appVulnerabilityTaskMitigationType
changeUefiSettingsPermission
deviceAppManagementTaskCategory
deviceAppManagementTaskPriority
deviceAppManagementTaskStatus
deviceManagementApplicabilityRuleType
deviceManagementComparisonResult
deviceManagementDomainJoinConnectorState
deviceManagementTemplateType
macOSFileVaultRecoveryKeyTypes
managedAppNotificationRestriction
mobileAppDependencyType
secureBootWithDMAType
vpnClientAuthenticationType
vpnDeadPeerDetectionRate
vpnEncryptionAlgorithmType
vpnIntegrityAlgorithmType
vpnLocalIdentifier
vpnServerCertificateType
windows10DeviceModeType
Addition beta Added the updateStatus action on deviceAppManagementTask
Addition beta Added the assign action on roleScopeTag
Addition beta Added the compare function on deviceManagementTemplate
Addition beta Added the compare function on deviceManagementIntent
Deletion beta Removed the following enum types:
mobileAppDependecyType
Addition beta Added the deviceManagementApplicabilityRuleOsEdition, deviceManagementApplicabilityRuleOsVersion and deviceManagementApplicabilityRuleDeviceMode properties to the deviceConfiguration entity
Addition beta Added the securityKeyForSignIn property to the deviceEnrollmentWindowsHelloForBusinessConfiguration entity
Addition beta Added the roleScopeTagIds property to the deviceManagementIntent entity
Addition beta Added the templateType and publishedDateTime properties to the deviceManagementTemplate entity
Addition beta Added the customPrivacyMessage property to the intuneBrandingProfile entity
Addition beta Added the fileVaultEnabled, fileVaultSelectedRecoveryKeyTypes, fileVaultInstitutionalRecoveryKeyCertificate, fileVaultInstitutionalRecoveryKeyCertificateFileName, fileVaultPersonalRecoveryKeyHelpMessage, fileVaultAllowDeferralUntilSignOut, fileVaultNumberOfTimesUserCanIgnore, fileVaultDisablePromptAtSignOut and fileVaultPersonalRecoveryKeyRotationInMonths properties to the macOSEndpointProtectionConfiguration entity
Addition beta Added the notificationRestriction property to the managedAppProtection entity
Change beta Changed the type of the following properties on the mobileAppDependency entity:
dependencyType from mobileAppDependecyType to mobileAppDependencyType
Addition beta Added the deviceGuardSecureBootWithDMA property to the windows10EndpointProtectionConfiguration entity
Addition beta Added the smartScreenAppInstallControl and lockScreenActivateAppsWithVoice properties to the windows10GeneralConfiguration entity
Addition beta Added the deviceAppManagementTasks navigation property to the deviceAppManagement entity
Addition beta Added the domainJoinConnectors navigation property to the deviceManagement entity
Addition beta Added the assignments navigation property to the roleScopeTag entity
Addition beta Added the isReadOnly property to the omaSettingInteger complex type
Addition beta Added the v10_1809 and v10_1903 properties to the windowsMinimumOperatingSystem complex type
Addition beta Added the wpa2Enterprise member to the androidWiFiSecurityType enum type
Addition beta Added the ikEv2 member to the appleVpnConnectionType enum type
Addition beta Added the rotateFileVaultKey and getFileVaultKey members to the remoteAction enum type
Addition beta Added the sharedSecret member to the vpnAuthenticationMethod enum type
Addition beta Added the windows10Home, windows10HomeChina, windows10HomeN, windows10HomeSingleLanguage, windows10Mobile, windows10IoTCore and windows10IoTCoreCommercial members to the windows10EditionType enum type

Identity and access (Azure AD)

Change type Version Description
Addition beta Added the riskDetection API, which represents risk detections in Azure AD Identity Protection.
Addition Beta Introduced the new resource type applicationTemplate. This resource type supports instantiate, list and get applications from the Azure AD application gallery.
Addition beta Added new resources:
detailsInfo
initiator
modifiedProperty
provisionedIdentity
provisioningObjectsummary
provisioningStep
provisioningsystemDetails
statusBase
Addition beta Added the List provisioningObjectSummary operation
Addition v1.0 Added the signInSessionsValidFromDateTime property on the user resource.
Addition v1.0 Added the revokeSignInSessions action on the user resource.

Mail (Outlook)

Change type Version Description
Addition beta Added support for the Mail.ReadBasic permission in mailFolder API: list mailfolders, get a mailfolder, list child folders and list messages in a mail folder. Also added Mail.ReadBasic support in delta query for message and delta query for mailFolder.

Reports | Identity and access reports

Change type Version Description
Addition beta Added new reports for retrieving user registration and usage information:

Sites and lists (SharePoint)

Change type Version Description
Addition Beta Added the followSite navigation property to the user entity set
Addition Beta Added the unfollowSite navigation property to the user entity set

Teamwork (Microsoft Teams)

Change type Version Description
Addition beta Added the teamDiscoverySettings resource and associated methods.

Users

Change type Version Description
Addition Beta Added the lastPasswordChangeDateTime property to the user entity.

May 2019

Calendar, mail, personal contacts (Outlook)

Change type Version Description
Addition v1.0 and beta Added the capability for administrators to limit app access to only specific mailboxes, even when an app has been granted application permissions to mail, mailbox settings, calendars, or contacts. For more details, see Scoping application permissions to specific Exchange Online mailboxes.

Devices and apps (Microsoft Intune)

Change type Version Description
Addition beta Added new entities:
deviceManagementDerivedCredentialSettings
iosDerivedCredentialAuthenticationConfiguration
securityBaselineCategoryStateSummary
Addition beta Added new enum types:
deviceManagementDerivedCredentialIssuer
deviceManagementDerivedCredentialNotificationType
emailCertificateType
mobileAppDependencyType
Addition beta Added the executeAction action on managedDevice collection
Addition beta Added the rotateFileVaultKey action on managedDevice
Addition beta Added the migrateToTemplate action on deviceManagementIntent
Addition beta Added the getFileVaultKey function on managedDevice
Deletion beta Removed the following enum types:
mobileAppDependecyType
Deletion beta Removed the executeAction action on managedDevice collection
Addition beta Added the usernameFormatString, passwordFormatString and preSharedKey properties to the androidEnterpriseWiFiConfiguration entity
Addition beta Added the customBrowserPackageId and customBrowserDisplayName properties to the androidManagedAppProtection entity
Addition beta Added the customBrowserProtocol, customBrowserPackageId and customBrowserDisplayName properties to the defaultManagedAppProtection entity
Deletion beta Removed the thirdPartyKeyboardsBlocked property from the defaultManagedAppProtection entity
Change beta Changed the following properties on the deviceManagementAbstractComplexSettingInstance entity:
implementationId from required to optional
Addition beta Added the versionInfo, isDeprecated and intentCount properties to the deviceManagementTemplate entity
Addition beta Added the assignedUserPrincipalName property to the importedWindowsAutopilotDeviceIdentity entity
Addition beta Added the signingCertificateType and encryptionCertificateType properties to the iosEasEmailProfileConfiguration entity
Addition beta Added the usernameFormatString and passwordFormatString properties to the iosEnterpriseWiFiConfiguration entity
Addition beta Added the kioskModeBlockAutoLock, kioskModeBlockRingerSwitch, kioskModeBlockScreenRotation, kioskModeBlockSleepButton, kioskModeBlockTouchscreen, cellularBlockPersonalHotspotModification and siriDisableServerLogging properties to the iosGeneralDeviceConfiguration entity
Addition beta Added the customBrowserProtocol property to the iosManagedAppProtection entity
Deletion beta Removed the thirdPartyKeyboardsBlocked property from the iosManagedAppProtection entity
Addition beta Added the iCloudBlockPhotoLibrary, screenCaptureBlocked, classroomAppBlockRemoteScreenObservation, classroomAppForceUnpromptedScreenObservation, classroomForceAutomaticallyJoinClasses, classroomForceRequestPermissionToLeaveClasses and classroomForceUnpromptedAppAndDeviceLock properties to the macOSGeneralDeviceConfiguration entity
Addition beta Added the retireAfterDateTime property to the managedDevice entity
Change beta Changed the type of the following properties on the mobileAppDependency entity:
dependencyType from mobileAppDependecyType to mobileAppDependencyType
Addition beta Added the tpmRequired property to the windows10CompliancePolicy entity
Addition beta Added the roleScopeTagIds property to the windowsAutopilotDeploymentProfile entity
Addition beta Added the configDeviceHealthMonitoringCustomScope property to the windowsHealthMonitoringConfiguration entity
Addition beta Added the migratableTo navigation property to the deviceManagementTemplate entity
Addition beta Added the derivedCredentialSettings navigation property to the iosEasEmailProfileConfiguration entity
Addition beta Added the derivedCredentialSettings navigation property to the iosEnterpriseWiFiConfiguration entity
Addition beta Added the derivedCredentialSettings navigation property to the iosVpnConfiguration entity
Addition beta Added the categoryDeviceStateSummaries navigation property to the securityBaselineTemplate entity
Addition beta Added the wpaEnterprise member to the androidDeviceOwnerWiFiSecurityType enum type
Addition beta Added the unknown member to the devicePlatformType enum type
Addition beta Added the derivedCredential member to the easAuthenticationMethod enum type
Addition beta Added the wipe member to the managedDeviceRemoteAction enum type
Change beta Changed the type of the following properties on the managedDeviceRemoteAction enum type:
fullScan from 2 to 3
quickScan from 3 to 4
signatureUpdate from 4 to 5
Addition beta Added the derivedCredential member to the vpnAuthenticationMethod enum type
Addition beta Added the derivedCredential member to the wiFiAuthenticationMethod enum type

Files (OneDrive)

Change type Version Description
Addition Beta Added the bundle complex type
Addition Beta Added the album complex type
Addition Beta Added the bundles navigation property to the drive entity
Addition Beta Added the bundle property to the driveItem entity
Addition Beta Added the grant action to the permission entity

Education

Change type Version Description
Addition beta Added taughtClasses to educationUser.
Addition beta Added educationCourse to educationClass.
Addition beta Added delta support to educationUser.
Addition beta Added delta to educationSchool.
Addition beta Added delta to educationClass.
Addition beta Added faculty option to educationUserRole enumeration.

Groups

Change type Version Description
Addition beta Added assignedlabels property to the group entity. This property represents the list of sensitivity label pairs (label ID, label name) associated with a group.

Identity and access (Azure AD) | Identity protection

Change type Version Description
Addition Beta Added the riskyUserHistoryItem entity.
Addition Beta Added the list history operation.

Mail (Outlook)

Change type Version Description
Addition v1.0 Added the mailSearchFolder entity, which is derived from and supports the methods of the mailFolder entity.

Reports | Office 365 usage reports

Change type Version Description
Addition Beta Added ownerPrincipalName property to the oneDriveUsageAccountDetail entity.
Addition Beta Added ownerPrincipalName property to the sharePointSiteUsageDetail entity.

Security

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

Teamwork (Microsoft Teams)

Change type Version Description
Addition Beta Added urgent property to the chatMessageImportance enum.
Addition Beta Added hostedContents navigation property to the chatMessage entity.
Addition Beta Added chatMessageHostedContent entity to represent content hosted by Microsoft Teams associated with a chatMessage.

April 2019

Change notifications (webhooks)

Change type Version Description
Addition beta Added two types of lifecycle notifications, subscriptionRemoved and missed, available for Outlook resources. Subscribing apps can take appropriate actions to mitigate notification interruptions. For more details, see Reduce missing subscriptions and notifications for Outlook resources (preview).

Devices and apps (Microsoft Intune)

Change type Version Description
Addition beta Added new entities:
androidDeviceOwnerCompliancePolicy

macOSExtensionsConfiguration

mobileAppDependency

mobileAppRelationship

Addition beta Added new complex types:
macOSKernelExtension

macOSLaunchItem

mobileAppRelationshipState

win32LobAppFileSystemRequirement

win32LobAppPowerShellScriptRequirement

win32LobAppRegistryRequirement

win32LobAppRequirement

Addition beta Added new enum types:
androidDeviceOwnerPlayStoreMode

mobileAppDependecyType

win32LobAppPowerShellScriptDetectionType

Addition beta Added the updateRelationships
action on mobileApp
Addition beta Added the import action on importedWindowsAutopilotDeviceIdentity
collection
Addition beta Added the getRelatedAppStates
function on mobileApp
Addition beta Added the kioskModeBluetoothConfigurationEnabled, kioskModeWiFiConfigurationEnabled, passwordMinimumLetterCharacters, passwordMinimumLowerCaseCharacters, passwordMinimumNonLetterCharacters, passwordMinimumNumericCharacters, passwordMinimumSymbolCharacters, passwordMinimumUpperCaseCharacters and playStoreMode properties to the androidDeviceOwnerGeneralDeviceConfiguration
entity
Addition beta Added the subjectAlternativeNameType property to the androidForWorkCertificateProfileBase
entity
Deletion beta Removed the subjectAlternativeNameType property from the androidForWorkPkcsCertificateProfile
entity
Deletion beta Removed the subjectAlternativeNameType property from the androidForWorkScepCertificateProfile
entity
Addition beta Added the subjectAlternativeNameType property to the androidWorkProfileCertificateProfileBase
entity
Deletion beta Removed the subjectAlternativeNameType property from the androidWorkProfilePkcsCertificateProfile
entity
Deletion beta Removed the subjectAlternativeNameType property from the androidWorkProfileScepCertificateProfile
entity
Addition beta Added the deviceNameTemplate property to the depEnrollmentBaseProfile
entity
Addition beta Added the importId property to the importedWindowsAutopilotDeviceIdentity
entity
Addition beta Added the autoLaunchItems, adminShowHostInfo, loginWindowText, authorizedUsersListHidden, authorizedUsersListHideLocalUsers, authorizedUsersListHideMobileAccounts, authorizedUsersListIncludeNetworkUsers, authorizedUsersListHideAdminUsers, authorizedUsersListShowOtherManagedUsers, shutDownDisabled, restartDisabled, sleepDisabled, consoleAccessDisabled, shutDownDisabledWhileLoggedIn, restartDisabledWhileLoggedIn, powerOffDisabledWhileLoggedIn, logOutDisabledWhileLoggedIn and screenLockDisableImmediate properties to the macOSDeviceFeaturesConfiguration
entity
Addition beta Added the dependentAppCount property to the mobileApp
entity
Addition beta Added the requirementRules property to the win32LobApp
entity
Deletion beta Removed the tpmRequired property from the windows10CompliancePolicy
entity
Addition beta Added the groupTag property to the windowsAutopilotDeviceIdentity
entity
Addition beta Added the users navigation property to the managedDevice
entity
Addition beta Added the relationships navigation property to the mobileApp
entity
Addition beta Added the customPrivacyMessage property to the intuneBrand
complex type
Addition beta Added the dependencyFailedToInstall, dependencyWithRequirementsNotMet, dependencyPendingReboot, dependencyWithAutoInstallDisabled, autoInstallDisabled, installingDependencies, powerShellScriptRequirementNotMet, registryRequirementNotMet and fileSystemRequirementNotMet members to the resultantAppStateDetail
enum type
Addition beta Added the doesNotExist member to the win32LobAppFileSystemDetectionType
enum type

Devices and apps (Microsoft Intune)

Change type Version Description
Addition beta Added new entities:
deviceManagementAbstractComplexSettingDefinition
deviceManagementAbstractComplexSettingInstance
deviceManagementBooleanSettingInstance
deviceManagementCollectionSettingDefinition
deviceManagementCollectionSettingInstance
deviceManagementComplexSettingDefinition
deviceManagementComplexSettingInstance
deviceManagementIntegerSettingInstance
deviceManagementIntent
deviceManagementIntentAssignment
deviceManagementIntentDeviceSettingStateSummary
deviceManagementIntentDeviceState
deviceManagementIntentDeviceStateSummary
deviceManagementIntentSettingCategory
deviceManagementIntentUserState
deviceManagementIntentUserStateSummary
deviceManagementSettingCategory
deviceManagementSettingDefinition
deviceManagementSettingInstance
deviceManagementStringSettingInstance
deviceManagementTemplate
deviceManagementTemplateSettingCategory
securityBaselineDeviceState
securityBaselineSettingState
securityBaselineState
securityBaselineStateSummary
securityBaselineTemplate
Addition beta Added new complex types:
deviceManagementConstraint
deviceManagementEnumConstraint
deviceManagementEnumValue
deviceManagementSettingBooleanConstraint
deviceManagementSettingDependency
deviceManagementSettingIntegerConstraint
deviceManagementSettingRegexConstraint
deviceManagementSettingStringLengthConstraint
deviceManagementSettingXmlConstraint
Addition beta Added new enum types:
deviceManangementIntentValueType
securityBaselineComplianceState
Addition beta Added the createInstance action on deviceManagementTemplate
Addition beta Added the updateSettings action on deviceManagementIntent
Addition beta Added the assign action on deviceManagementIntent
Addition beta Added the intents, settingDefinitions, templates and categories navigation properties to the deviceManagement entity
Addition beta Added the securityBaselineStates navigation property to the managedDevice entity

Files, sites and lists (OneDrive for Business and SharePoint)

Change type Version Description
Addition v1.0 Added the analytics property to the driveItem entity.
Addition v1.0 Added the analytics property to the site entity.
Addition v1.0 Added the analytics property to the listItem entity.
Addition v1.0 Added the getActivitiesByInterval function on the driveItem entity.
Addition v1.0 Added the getActivitiesByInterval function on the site entity.
Addition v1.0 Added the getActivitiesByInterval function on the listItem entity.
Addition v1.0 Added the itemAnalytics entity.
Addition v1.0 Added the itemActivityStat entity.
Addition v1.0 Added the itemActionStat complex type.
Addition v1.0 Added the accessAction complex type.
Addition v1.0 Added the incompleteData complex type.
Addition v1.0 Added the access property to the itemActivity complex type.
Addition v1.0 Added the location property to the itemActivity complex type.

Identity and access (Azure AD)

Change type Version Description
Addition v1.0 Introduced the new audit logs APIs for Azure AD providing activity logs for directory management tasks through directoryAudit and sign-in activity through signIns.
Addition beta Added new application permissions for access reviews APIs: AccessReview.Read.All, ProgramControl.Read.All and ProgramControl.ReadWrite.All. For details, see the access reviews API reference.
Addition beta Add the signInSessionsValidFromDateTime property on the user resource. This is a rename of the refreshTokensValidFromDateTime properties, but both properties will be supported to allow clients to migrate smoothly. In the next couple months the old property, refreshTokensValidFromDateTime will be removed.
Addition beta Add the revokeSignInSessions action on the user resource. This is a rename of the invalidateAllRefreshTokens action, but both service actions will be supported to allow clients to migrate smoothly. In the next couple months the old service action, invalidateAllRefreshTokens will be removed.
Addition Beta Introduced a new resource type trustFrameworkPolicy to support Azure Active Directory B2C. This resource type supports create, list, get, update, and delete operations.

Mail (Outlook)

Change type Version Description
Addition Beta Added support for a new Mail.ReadBasic (preview) permission for List Messages and Get Message.
Addition Beta Added the capability to get the MIME content of a message.
Addition Beta Added the capability to get the raw contents of a file or item attachment to an event, message, Outlook task, or group post.

Teamwork (Microsoft Teams)

Change type Version Description
Addition v1.0 Added support for application permissions to the installedApps resource.
Addition v1.0 Added the email and webUrl properties to channel.
Addition beta Added the chat resources and associated methods.
Addition beta Added APIs to read images in messages.
Addition beta Added the conversation member resources and associated methods.

March 2019

Calendar (Outlook)

Change type Version Description
Addition v1.0 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.
Change Beta Rolled back the type changes related to findMeetingTimes documented in February 2019. The specific changes are listed in the following rows.
Change Beta Changed the data type of the following parameters of findMeetingTimes:
attendees: from attendeeDataModel back to attendeeBase
locationConstraint: from locationConstraints back to locationConstraint
timeConstraint: from findMeetingTimesTimeConstraints back to timeConstraint
Change Beta Changed the return type of findMeetingTimes from findMeetingTimesResponse back to meetingTimeSuggestionsResult
Change Beta Changed the base type of locationConstraintItem from locationDataModel back to location
Change Beta Changed the data types of the following properties of meetingTimeSuggestion:
attendeeAvailability: from collection of attendeeAvailabilityDataModel back to collection of attendeeAvailability
locations: from collection of locationDataModel back to collection of location
meetingTimeSlot: from meetingTimeSlotDataModel back to timeSlot
organizerAvailability: from availabilityStatus back to freeBusyStatus
Deletion Beta Complex types:
attendeeAvailabilityDataModel
attendeeDataModel
findMeetingTimesResponse
findMeetingTimesTimeConstraints
locationConstraints
meetingTimeSlotDataModel
searchWindowTimeSlot
Deletion Beta Enumerations:
addressType
availabilityStatus
Addition Beta Restored the following complex types:
attendeeAvailability
locationConstraint
meetingTimeSuggestionsResult
timeConstraint

Devices and apps (Microsoft Intune)

Change type Version Description
Addition beta Added new entities:
windowsHealthMonitoringConfiguration
Addition beta Added new complex types:
windowsFirewallRule
Addition beta Added new enum types:
androidManagedAppSafetyNetAppsVerificationType
androidManagedAppSafetyNetDeviceAttestationType
windowsAutopilotDeviceType
windowsFirewallRuleInterfaceTypes
windowsFirewallRuleNetworkProfileTypes
windowsFirewallRuleTrafficDirectionType
windowsHealthMonitoringScope
windowsUpdateNotificationDisplayOption
Addition beta Added the searchExistingIdentities action on importedDeviceIdentity collection
Addition beta Added the assignResourceAccountToDevice action on windowsAutopilotDeviceIdentity
Addition beta Added the unassignResourceAccountFromDevice action on windowsAutopilotDeviceIdentity
Deletion beta Removed the following enum types:
defenderScheduleScanDay
Addition beta Added the requiredAndroidSafetyNetDeviceAttestationType, appActionIfAndroidSafetyNetDeviceAttestationFailed, requiredAndroidSafetyNetAppsVerificationType and appActionIfAndroidSafetyNetAppsVerificationFailed properties to the androidManagedAppProtection entity
Addition beta Added the supportsOemConfig property to the androidManagedStoreApp entity
Addition beta Added the appSupportsOemConfig property to the androidManagedStoreAppConfiguration entity
Addition beta Added the requiredAndroidSafetyNetDeviceAttestationType, appActionIfAndroidSafetyNetDeviceAttestationFailed, requiredAndroidSafetyNetAppsVerificationType and appActionIfAndroidSafetyNetAppsVerificationFailed properties to the defaultManagedAppProtection entity
Addition beta Added the iCloudStorageDisabled and chooseYourLockScreenDisabled properties to the depMacOSEnrollmentProfile entity
Addition beta Added the roleScopeTagIds property to the iosLobAppProvisioningConfiguration entity
Addition beta Added the allowedOutboundClipboardSharingExceptionLength property to the managedAppProtection entity
Addition beta Added the fastFirstSignIn property to the sharedPCConfiguration entity
Addition beta Added the tpmRequired property to the windows10CompliancePolicy entity
Addition beta Added the firewallRules property to the windows10EndpointProtectionConfiguration entity
Addition beta Added the authenticationWebSignIn, privacyDisableLaunchExperience and appManagementPackageFamilyNamesToLaunchAfterLogOn properties to the windows10GeneralConfiguration entity
Deletion beta Removed the defenderScheduleScanDay property from the windows10GeneralConfiguration entity
Addition beta Added the deviceType property to the windowsAutopilotDeploymentProfile entity
Addition beta Added the resourceName, skuNumber, systemFamily, azureActiveDirectoryDeviceId and managedDeviceId properties to the windowsAutopilotDeviceIdentity entity
Deletion beta Removed the edgeKioskResetAfterIdleTimeInMinutes property from the windowsKioskConfiguration entity
Addition beta Added the userWindowsUpdateScanAccess and updateNotificationLevel properties to the windowsUpdateForBusinessConfiguration entity
Addition beta Added the teams property to the excludedApps complex type
Addition beta Added the autoLaunch property to the windowsKioskAppBase complex type
Addition beta Added the allowAccessToDownloadsFolder property to the windowsKioskMultipleApps complex type
Addition beta Added the lowSecurityBiometric member to the androidDeviceOwnerRequiredPasswordType enum type
Addition beta Added the androidBootloaderUnlocked and androidFactoryRomModified members to the managedAppFlaggedReason enum type

Education

Change type Version Description
Addition beta Add the new educationCategory resource.
Addition beta Add APIs to manage educationCategory resources on educationClass and educationAssignment.
Addition beta Add the new educationFormResource resource.
Addition beta Add the recipients property on the educationAssignmentIndividualRecipient resource.

Files (OneDrive for Business)

Change type Version Description
Addition v1.0 Added the subscriptions navigation property to the driveItem entity
Addition Beta Added the expirationDateTime property to the driveItem_invite DateTimeOffset type.
Addition Beta Added the password property to the driveItem_invite string type.

Financials (Dynamics 365 Business Central)

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

Identity and access (directory APIs)

Change type Version Description
Addition v1.0 Add the passwordNotificationWindowInDays and passwordValidityPeriodInDays properties on the domain resource.
Addition beta and v1.0 Add the complianceExpirationDateTime, profileType and systemLabels properties on the device resource.
Addition beta and v1.0 Add the isResourceAccount property on the user resource.

Identity and access | Identity protection

Change type Version Description
Addition beta Introduced Confirm riskyUsers compromised method, which allows admins to confirm users as compromised in Azure AD Identity Protection.
Addition beta Introduced Dismiss riskyUsers method, which allows admins to dismiss users marked as risky in Azure AD Identity Protection.
Addition beta Introduced isProcessing property to the riskyUser resource.

Teamwork (Microsoft Teams)

Change type Version Description
Removal beta Removed the deleted property from chatMessage. Use deletedDateTime instead.
Addition beta Added the schedule, schedulingGroup, shift, timeOffReason and timeOff resources and associated methods.

February 2019

Calendar (Outlook)

Change type Version Description
Change Beta Changed the data type of the following parameters of findMeetingTimes:
attendees: from attendeeBase to attendeeDataModel
locationConstraint: from locationConstraint to locationConstraints
timeConstraint: from timeConstraint to findMeetingTimesTimeConstraints
Change Beta Changed the return type of findMeetingTimes from meetingTimeSuggestionsResult to findMeetingTimesResponse
Change Beta Changed the response payload of findMeetingTimes to exclude the type of each attendee that identifies whether the attendee is required, optional, or is a resource
Change Beta Changed the base type of locationConstraintItem from location to locationDataModel
Change Beta Changed the data types of the following properties of meetingTimeSuggestion:
attendeeAvailability: from collection of attendeeAvailability to collection of attendeeAvailabilityDataModel
locations: from collection of location to collection of locationDataModel
meetingTimeSlot: from timeSlot to meetingTimeSlotDataModel
organizerAvailability: from freeBusyStatus to availabilityStatus
Addition Beta New complex types:
attendeeAvailabilityDataModel
attendeeDataModel
findMeetingTimesResponse
findMeetingTimesTimeConstraints
locationConstraints
locationDataModel
meetingTimeSlotDataModel
postalAddress
searchWindowTimeSlot
Addition Beta New enumerations:
addressType
availabilityStatus
Addition Beta Added the order property to meetingTimeSuggestion
Deletion Beta Removed the following complex types:
attendeeAvailability
locationConstraint
meetingTimeSuggestionsResult
timeConstraint

Devices and apps (Microsoft Intune)

Change type Version Description
Addition beta Added new entities:
androidOmaCpConfiguration
managedDeviceEncryptionState
Addition beta Added new complex types:
deliveryOptimizationBandwidth
deliveryOptimizationBandwidthAbsolute
deliveryOptimizationBandwidthBusinessHoursLimit
deliveryOptimizationBandwidthHoursWithPercentage
deliveryOptimizationBandwidthPercentage
deliveryOptimizationGroupIdCustom
deliveryOptimizationGroupIdSource
deliveryOptimizationGroupIdSourceOptions
deliveryOptimizationMaxCacheSize
deliveryOptimizationMaxCacheSizeAbsolute
deliveryOptimizationMaxCacheSizePercentage
encryptionReportPolicyDetails
Addition beta Added new enum types:
advancedBitLockerState
deliveryOptimizationGroupIdOptionsType
deliveryOptimizationRestrictPeerSelectionByOptions
deviceTypes
edgeKioskModeRestrictionType
encryptionReadinessState
encryptionState
Addition beta Added the roleScopeTagIds property to the depOnboardingSetting entity
Addition beta Added the autoFillForceAuthentication, cellularBlockPlanModification, classroomForceAutomaticallyJoinClasses, classroomForceUnpromptedAppAndDeviceLock, esimBlockModification, proximityBlockSetupToNewDevice, softwareUpdatesEnforcedDelayInDays and softwareUpdatesForceDelayed properties to the iosGeneralDeviceConfiguration entity
Addition beta Added the softwareUpdatesEnforcedDelayInDays, softwareUpdatesForceDelayed and contentCachingBlocked properties to the macOSGeneralDeviceConfiguration entity
Addition beta Added the licensingType property to the microsoftStoreForBusinessApp entity
Addition beta Added the defenderSecurityCenterDisableClearTpmUI, defenderSecurityCenterDisableNotificationAreaUI, defenderSecurityCenterDisableVulnerableTpmFirmwareUpdateUI, defenderAdobeReaderLaunchChildProcess and defenderOfficeCommunicationAppsLaunchChildProcess properties to the windows10EndpointProtectionConfiguration entity
Addition beta Added the edgeKioskModeRestriction, edgeKioskResetAfterIdleTimeInMinutes, defenderScheduleScanEnableLowCpuPriority, defenderDisableCatchupQuickScan, defenderDisableCatchupFullScan and edgeBlockSearchEngineCustomization properties to the windows10GeneralConfiguration entity
Addition beta Added the enableWhiteGlove property to the windowsAutopilotDeploymentProfile entity
Addition beta Added the restrictPeerSelectionBy, groupIdSource, bandwidthMode, backgroundDownloadFromHttpDelayInSeconds, foregroundDownloadFromHttpDelayInSeconds, minimumRamAllowedToPeerInGigabytes, minimumDiskSizeAllowedToPeerInGigabytes, minimumFileSizeToCacheInMegabytes, minimumBatteryPercentageAllowedToUpload, modifyCacheLocation, maximumCacheAgeInDays, maximumCacheSize and vpnPeerCaching properties to the windowsDeliveryOptimizationConfiguration entity
Addition beta Added the lastCheckInDateTime property to the windowsInformationProtectionWipeAction entity
Addition beta Added the managedDeviceEncryptionStates navigation property to the deviceManagement entity
Addition beta Added the endpointProtection and officeApps properties to the configurationManagerClientEnabledFeatures complex type
Addition beta Added the productName and publisher properties to the win32LobAppMsiInformation complex type
Addition beta Added the warn member to the managedAppRemediationAction enum type

Education

Change type Version Description
Addition beta Introduced new relatedContacts property on educationUser.
Addition v1.0 Introduced new relatedContacts property on educationUser.

Files (OneDrive for Business)

Change type Version Description
Addition Beta Added the expirationDateTime property to the driveItem_invite DateTimeOffset type.
Addition Beta Added the password property to the driveItem_invite string type.

Identity and access (directory APIs)

Change type Version Description
Addition v1.0 Added new resource type directoryObjectPartnerReference.
Addition beta and v1.0 Add the createdDateTime property on organization.
Change beta and v1.0 Updated the companyName property on the user resource to be writeable.
Change beta The targetResource type now includes properties previously available to derived types that are no longer supported.
Deletion beta The following derived types are no longer supported and have been removed: targetResourceDevice, targetResourceDirectory, targetResourceGroup, targetResourcePolicy, targetResourceRole, targetResourceServicePrincipal, targetResourceUser, and targetResourceOther.
Addition beta Add the passwordNotificationWindowInDays and passwordValidityPeriodInDays properties on the domain resource.

Notes (OneNote)

Change type Version Description
Addition beta and v1.0 Added the getNotebookFromWebUrl method.

Security

Change type Version Description
Addition Beta Added the threat intelligence (TI) indicator APIs to the security API, including the following resources and operations:
tiindicator (and related entities)
Get tiIndicator
Create tiIndicator
List tiIndicators
Update tiIndicator
Delete tiIndicator
deleteTiIndicators
deleteTiIndicatorsByExternalId
submitTiIndicators
updateTiIndicators
Addition Beta Added the security action APIs to the security API, including the following resources and operations:
securityAction (and related entities)
Get securityAction
Create securityAction
List securityAction
Cancel securityAction
Addition Beta Introduced new complex type historyStates collection to alert.
Added updateAlerts functionality to update multiple alerts in one request.

Teamwork (Microsoft Teams)

Change type Version Description
Addition beta and v1.0 Added the internalId property to the team resource.
Addition beta and v1.0 Added support for configuring Word, Excel, PowerPoint, PDF, and document library tabs.
Addition beta Introduced the Send a message to a channel API.
Addition beta Introduced the Reply to a message in a channel API.
Deletion beta Removed the POST /teams/{id}/channels/{id}/chatThreads API. Use Create a message in a channel instead.
Addition beta Added support for application permissions to the installedApps resource.

January 2019

Devices and apps (Microsoft Intune)

Change type Version Description
Addition beta Added new entities:
appleVppTokenTroubleshootingEvent
appLogCollectionRequest
windowsUpdateState
Addition beta Added new complex types:
appLogCollectionDownloadDetails
deviceManagementTroubleshootingErrorDetails
deviceManagementTroubleshootingErrorResource
win32LobAppAssignmentSettings
Addition beta Added new enum types:
appLogDecryptionAlgorithm
appLogUploadState
win32LobAppNotification
windowsUpdateStatus
Addition beta Added the createDownloadUrl action on appLogCollectionRequest
Deletion beta Removed the following entities:
deviceManagementApplicabilityRuleOsEdition
deviceManagementApplicabilityRuleOsVersion
Addition beta Added the passwordSignInFailureCountBeforeFactoryReset property to the androidCompliancePolicy entity
Addition beta Added the passwordSignInFailureCountBeforeFactoryReset property to the androidForWorkCompliancePolicy entity
Addition beta Added the passwordSignInFailureCountBeforeFactoryReset property to the androidWorkProfileCompliancePolicy entity
Deletion beta Removed the defaultProfileDisplayName property from the depOnboardingSetting entity
Addition beta Added the runAs32Bit property to the deviceManagementScript entity
Addition beta Added the troubleshootingErrorDetails, eventName and additionalInformation properties to the deviceManagementTroubleshootingEvent entity
Change beta Changed the following properties on the macOSCertificateProfileBase entity:
subjectAlternativeNameType from required to optional
Addition beta Added the certificateStore and customSubjectAlternativeNames properties to the macOSScepCertificateProfile entity
Addition beta Added the officeConfigurationXml property to the officeSuiteApp entity
Addition beta Added the createdDateTime property to the organization entity
Addition beta Added the bitLockerAllowStandardUserEncryption property to the windows10EndpointProtectionConfiguration entity
Deletion beta Removed the localSecurityOptionsEnableAdministratorAccount, localSecurityOptionsEnableGuestAccount and lanManagerWorkstationEnableInsecureGuestLogons properties from the windows10EndpointProtectionConfiguration entity
Addition beta Added the useSecurityKeyForSignin property to the windowsIdentityProtectionConfiguration entity
Addition beta Added the mobileAppTroubleshootingEvents navigation property to the deviceManagement entity
Addition beta Added the appLogCollectionRequests navigation property to the mobileAppTroubleshootingEvent entity

Identity and access (Azure AD)

Change type Version Description
Addition v1.0 To support configuring an identity provider in an Azure AD B2C tenant, introduced new resource type identityProvider entity and the create, list, get, update, and delete operations.

Identity and access (directory APIs)

Change type Version Description
Addition v1.0 Added new method transitiveMembers on groups. This method returns a flat list of members including nested members.
Addition v1.0 Added new method transitiveMemberOf on users, groups and devices.
Addition v1.0 Added new properties to users: employeeId, faxNumber, onPremisesDistinguishedName, showInAddressList and otherMails.
Addition v1.0 Added the forceChangePasswordNextSignInWithMfa property to the passwordProfile complex type.
Addition v1.0 Added the licenseAssignmentStates property to the User entity for Group Based Licensing.
Addition v1.0 Added the licenseAssignmentState resource for Group Based Licensing.
Addition v1.0 Added the assignedLicenses, licenseProcessingState and hasMembersWithLicenseErrors properties and membersWithLicenseErrors relationship to Group entity for Group Based Licensing.
Addition beta Added the createdDateTime property to the user resource.

Reports

Change type Version Description
Addition Beta Added the office365Active and office365Inactive properties to the office365ServicesUserCounts entity.

Teamwork (Microsoft Teams)

Change type Version Description
Addition beta Added educationStandard, educationClass, educationProfessionalLearningCommunity, educationStaff, and unknownFutureValue to the teamSpecialization enum.

December 2018

Identity and access | Data policy operation

Change type Version Description
Addition v1.0 Added new entity dataPolicyOperation. This represents a submitted data policy operation for tracking purposes.
Addition v1.0 Added the exportPersonalData action on users. This action submits a data policy operation request to export personal data stored by Microsoft for a user.
Addition v1.0 Added method dataPolicyOperations. This retrieves properties of the dataPolicyOperation object.

Identity and access (directory APIs)

Change type Version Description
Addition beta Added new property expirationDateTime to groups for group expiration.
Addition beta Added new resource type directoryObjectPartnerReference.
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.
Change Beta Restructured the organizational contacts resource. The physical address properties (city, country, postalCode, streetAddress, and state) and officeLocation are now in an addresses collection (of new physicalOfficeAddress resource type), and mobilePhone, businessPhones and faxNumber are now in a phones collection. companyName and imAddresses have also been added

Identity and access | Privileged Identity Management

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.

Security

Change type Version Description
Addition Beta Introduced new complex type complianceInformation.
Addition Beta Introduced new complex type certificationControl.

Teamwork (Microsoft Teams)

Change type Version Description
Addition beta Introduced new resource type teamsTemplate.
Addition beta Introduced new resource type teamSpecialization.
Addition beta Added the isFavoriteByDefault, email, 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.
Addition v1.0 Added admin permissions support to team, channel, and tab operations.

November 2018

Identity and access | Data policy operations

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

Identity and access (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.
Addition beta Added the 'externalUserState' and 'externalUserStateChangeDateTime' properties to the user object.

Reports

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.

Teamwork (Microsoft Teams)

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.

October 2018

Devices and apps (Microsoft Intune)

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

Identity and access | Audit logs

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.

Identity and access (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.
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.

Identity and access | Identity protection

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.

Identity and access | Privileged Identity Management

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

Personal contacts (Outlook)

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

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

Teamwork (Microsoft Teams)

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

Track changes

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.

September 2018

Calls and online meetings

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 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.

Data access (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).

Devices and apps (Microsoft Intune)

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

Files, sites, and lists (OneDrive for Business and SharePoint)

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 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

Financials (Dynamics 365 Business Central)

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

Mail (Outlook)

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

Notifications (Project Rome)

Change type Version Description
Addition Beta Added the notification resource type.
Addition Beta Added the Create and publish notification API.

Security

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
Addition Beta Introduced new complex type secureScoreControlStateUpdate

Teamwork (Microsoft Teams)

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.

August 2018

Calendar (Outlook)

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.

Devices and apps (Microsoft Intune)

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

Identity and access (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

Mail (Outlook)

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

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

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.

Track changes

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

July 2018

Change notifications (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.

Identity and access

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.

Identity and access | Synchronization

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

Personal contacts (Outlook)

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.

Teamwork (Microsoft Teams)

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
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.

June 2018

Devices and apps (Microsoft Intune)

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

Identity and access (Azure AD)

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

Identity and access (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

Identity and access | Privileged Identity Management

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

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

Teamwork (Microsoft Teams)

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.

May 2018

Customer booking (Microsoft Bookings)

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.

Devices and apps (Microsoft Intune)

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

Education

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.

Identity and access (Azure AD)

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

Identity and access (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.

Social and workplace intelligence | Insights

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

April 2018

Calendar (Outlook)

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.

Cross-device experiences (Project Rome)

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

Devices and apps (Microsoft Intune)

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

Education

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.

Identity and access | Audit logs

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

Identity and access (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

Mail (Outlook)

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.

Personal contacts (Outlook)

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

Reports

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

Security

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
Security solution integrations using the Microsoft Graph Security API

Teamwork (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.

Users | Outlook settings

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

March 2018

Cross-device experiences (Project Rome)

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

Devices and apps (Microsoft Intune)

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

Files (OneDrive for Business)

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
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

Groups

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

Identity and access (Azure AD)

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.

Identity and access | 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.

Identity and access (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.

Identity and access | 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.

Reports

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

Workbooks and charts (Excel)

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.

February 2018

Devices and apps (Microsoft Intune)

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

Reports

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

Tasks and plans (Planner)

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

January 2018

Batch requests

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.

Devices and apps (Microsoft Intune)

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

Education

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

Reports

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

December 2017

Devices and apps (Microsoft Intune)

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

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

Track changes

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

November 2017

Change notifications (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.

Devices and apps (Microsoft Intune)

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

Education

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.

Identity and access | Synchronization

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.

Reports

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.

October 2017

Devices and apps (Microsoft Intune)

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

Identity and access (Azure AD)

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

Mail (Outlook)

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.

Reports

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.

Teamwork (Microsoft Teams)

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

Users | Outlook settings

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

September 2017

Calendar (Outlook)

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.

Devices and apps (Microsoft Intune)

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

Files (OneDrive for Business)

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.

Mail (Outlook)

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.

Personal contacts (Outlook)

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.

Sites and lists (SharePoint)

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.
Addition beta Added dataLocationCode and root properties to the SiteCollection complex type.

Users | Outlook settings

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.

August 2017

Devices and apps (Microsoft Intune)

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

Groups

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.

Notes (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.

Social and workplace intelligence | 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.

Users

Change type Version Description
Addition beta Added employeeId property to user

July 2017

Devices and apps (Microsoft Intune)

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

Identity and access | Group setting

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

June 2017

Calendar (Outlook)

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

Cross-device experiences (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

Devices and apps (Microsoft Intune)

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

Identity and access | Application

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.

Tasks and plans (Planner)

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

Cross-device experiences (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.

Identity and access | Administrative unit

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

Change notifications (webhooks)

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

Track changes

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

Files (OneDrive for Business)

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.

Add custom data (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.

Add custom data (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.

Groups

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

Social and workplace intelligence | Insights

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

Devices and apps (Microsoft Intune)

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