Microsoft
Microsoft Graph
Microsoft
This changelog covers what's changed in Microsoft Graph, including the v1.0 and beta endpoint Microsoft Graph APIs.
| 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. |
| Change type | Version | Description |
|---|---|---|
| Deletion | Beta | Removed the following entities: task plan bucket taskDetails planDetails taskBoardTaskFormat planTaskBoard |
| 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. |
| 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 type | Version | Description |
|---|---|---|
| Change | Beta | Added support to webhooks for users and groups. |
| 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. |
| Change type | Version | Description |
|---|---|---|
| Addition | Beta | Added support for restoring and permanently deleting users. |
| Change type | Version | Description |
|---|---|---|
| Addition | beta | New entity: OnPremisesProvisioningError |
| Change | beta | Added OnPremisesProvisioningError property to user, group, and orgcontact |
| 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. |
| Change type | Version | Description |
|---|---|---|
| Addition | V1.0 | Added operations on domains. New entities:domain domainDnsRecord domainDnsCnameRecord domainDnsMxRecord domainDnsSrvRecord domainDnsTxtRecord domainDnsUnavailableRecord New actions:verify |
| Change type | Version | Description |
|---|---|---|
| Addition | V1.0 | New entity: contract |
| Change type | Version | Description |
|---|---|---|
| Addition | v1.0 | New entity: licenseDetails |
| Change | v1.0 | New licensedetails navigation property on users |
| 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. |
| 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. |
| 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. |
| Change type | Version | Description |
|---|---|---|
| Addition | v1.0 and beta | Added the drives and sites navigation properties to group. |
| 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 |
| Change type | Version | Description |
|---|---|---|
| Addition | Beta | Added new entities: androidForWorkMobileAppConfiguration cartToClassAssociation deviceCompliancePolicySettingStateSummary eBookInstallSummary eBookVppGroupAssignment iosUpdateConfiguration remoteAssistancePartner windows10EndpointProtectionConfiguration windowsDeviceMalwareState windowsInformationProtectionAppLearningSummary windowsMalwareInformation windowsProtectionState |
| Addition | Beta | Added new complex types: androidPermissionAction bitLockerSystemDrivePolicy defenderDetectedMalwareActions settingSource |
| Addition | Beta | Added the assign action on managedEBook |
| Addition | Beta | Added the beginOnboarding action on remoteAssistancePartner |
| Addition | Beta | Added the disconnect action on remoteAssistancePartner |
| Deletion | Beta | Removed the following entities: outlookTask outlookTaskFolder outlookTaskGroup outlookUser windowsManagementAppHealthState |
| Deletion | Beta | Removed the following complex types: applePushNotificationCertificateSetting eventCreationOptions |
| Change | Beta | Added the workProfilePasswordBlockFingerprintUnlock, workProfilePasswordBlockTrustAgents, workProfilePasswordExpirationDays, workProfilePasswordMinimumLength, workProfilePasswordMinutesOfInactivityBeforeScreenTimeout, workProfilePasswordPreviousPasswordBlockCount, workProfilePasswordSignInFailureCountBeforeFactoryReset, workProfilePasswordRequiredType and workProfileRequirePassword properties to the androidForWorkGeneralDeviceConfiguration entity |
| Change | Beta | Added the subjectAlternativeNameFormatString property to the androidForWorkPkcsCertificateProfile entity |
| Change | Beta | Added the subjectNameFormatString and subjectAlternativeNameFormatString properties to the androidForWorkScepCertificateProfile entity |
| Change | Beta | Added the kioskModeManagedApps property to the androidGeneralDeviceConfiguration entity |
| Change | Beta | Removed the kioskModeManagedAppId property from the androidGeneralDeviceConfiguration entity |
| Change | Beta | Added the subjectAlternativeNameFormatString property to the androidPkcsCertificateProfile entity |
| Change | Beta | Added the subjectNameFormatString and subjectAlternativeNameFormatString properties to the androidScepCertificateProfile entity |
| Change | Beta | Removed the hexColor property from the calendar entity |
| Change | Beta | Added the setting and platformType properties to the complianceSettingStateSummary entity |
| Change | Beta | Removed the windowsManagementAppEnabled property from the deviceAppManagement entity |
| Change | Beta | Added the userName, deviceModel and platform properties to the deviceComplianceDeviceStatus entity |
| Change | Beta | Added the userPrincipalName and deviceModel properties to the deviceComplianceSettingState entity |
| Change | Beta | Added the platformType, setting, userId and userEmail properties to the deviceComplianceSettingState entity |
| Change | Beta | Added the inGracePeriodCount property to the deviceCompliancePolicyDeviceStateSummary entity |
| Change | Beta | Added the userName, deviceModel and platform properties to the deviceConfigurationDeviceStatus entity |
| Change | Beta | Removed the creationOptions property from the event entity |
| Change | Beta | Removed the isDelegated property from the eventMessage entity |
| Change | Beta | Removed the unseenConversationsCount and unseenMessagesCount properties from the group entity |
| Change | Beta | Added the settingXml and settings properties to the iosMobileAppConfiguration entity |
| Change | Beta | Added the subjectAlternativeNameFormatString property to the iosPkcsCertificateProfile entity |
| Change | Beta | Added the subjectAlternativeNameFormatString property to the iosScepCertificateProfile entity |
| Change | Beta | Added the systemIntegrityProtectionEnabled property to the macOSCompliancePolicy entity |
| Change | Beta | Added the subjectAlternativeNameFormatString property to the macOSScepCertificateProfile entity |
| Change | Beta | Added the complianceGracePeriodExpirationDateTime, userPrincipalName. and imei properties to the managedDevice entity |
| Change | Beta | Removed the settingXml and settings properties from the managedDeviceMobileAppConfiguration entity |
| Change | Beta | Added the useSharedComputerActivation, updateChannel, officePlatformArchitecture and localesToInstall properties to the officeSuiteApp entity |
| Change | Beta | Removed the applePushNotificationCertificateSetting property from the organization entity |
| Change | Beta | Changed the following properties on the post entity: sender from optional to required |
| Change | Beta | Added the compliantUserCount, nonCompliantUserCount, remediatedUserCount, errorUserCount, unknownUserCount, conflictUserCount and notApplicableUserCount properties to the softwareUpdateStatusSummary entity |
| Change | Beta | Added the bluetoothAllowedServices, bluetoothBlockPrePairing, cellularData, defenderDetectedMalwareActions, defenderPotentiallyUnwantedAppAction, lockScreenAllowTimeoutConfiguration, lockScreenBlockCortana, lockScreenBlockToastNotifications, lockScreenTimeoutInSeconds, passwordBlockSimple, privacyAutoAcceptPairingAndConsentPrompts, privacyBlockInputPersonalization, startMenuHideChangeAccountSettings, startMenuHideHibernate, startMenuHideLock, startMenuHideShutDown, startMenuHideSignOut, startMenuHideSleep, startMenuHideSwitchAccount, settingsBlockAppsPage, settingsBlockGamingPage, windowsSpotlightBlockConsumerSpecificFeatures, windowsSpotlightBlocked, windowsSpotlightBlockOnActionCenter, windowsSpotlightBlockTailoredExperiences, windowsSpotlightBlockThirdPartyNotifications, windowsSpotlightBlockWelcomeExperience, windowsSpotlightBlockWindowsTips, windowsSpotlightConfigureOnLockScreen and connectedDevicesServiceBlocked properties to the windows10GeneralConfiguration entity |
| Change | Beta | Removed the automaticUpdateMode, automaticUpdateSchedule, automaticUpdateTime, prereleaseFeatures, experienceBlockWindowsSpotlight, experienceBlockWindowsTips and experienceBlockConsumerSpecificFeatures properties from the windows10GeneralConfiguration entity |
| Change | Beta | Added the subjectAlternativeNameFormatString property to the windows10PkcsCertificateProfile entity |
| Change | Beta | Added the subjectNameFormatString and subjectAlternativeNameFormatString properties to the windows81SCEPCertificateProfile entity |
| Change | Beta | Added the indexingEncryptedStoresOrItemsBlocked and smbAutoEncryptedFileExtensions properties to the windowsInformationProtection entity |
| Change | Beta | Changed the following properties on the windowsInformationProtection entity: rightsManagementServicesTemplateId from required to optional |
| Change | Beta | Changed the following properties on the windowsMobileMSI entity: productCode from required to optional |
| Change | Beta | Added the subjectNameFormatString and subjectAlternativeNameFormatString properties to the windowsPhone81SCEPCertificateProfile entity |
| Change | Beta | Added the mobileAppConfigurations navigation property to the deviceAppManagement entity |
| Change | Beta | Added the cartToClassAssociations, deviceCompliancePolicySettingStateSummaries, remoteAssistancePartners, windowsInformationProtectionAppLearningSummaries and windowsMalwareInformation navigation properties to the deviceManagement entity |
| Change | Beta | Added the eBook navigation property to the eBookGroupAssignment entity |
| Change | Beta | Added the windowsProtectionState navigation property to the managedDevice entity |
| Change | Beta | Added the installSummary navigation property to the managedEBook entity |
| Change | Beta | Removed the outlook navigation property from the user entity |
| Change | Beta | Removed the healthStates navigation property from the windowsManagementApp entity |
| Change | Beta | Added the androidForWorkRestrictions property to the defaultDeviceEnrollmentRestrictions complex type |
| Change | Beta | Added the userPrincipalName and sources properties to the deviceCompliancePolicySettingState complex type |
| Change | Beta | Added the userPrincipalName and sources properties to the deviceConfigurationSettingState complex type |
| Change | Beta | Added the settingName, userId, userName, userEmail and currentValue properties to the deviceConfigurationSettingState complex type |
| Change | Beta | Removed the archiveFolder property from the mailboxSettings complex type |
| Change type | Version | Description |
|---|---|---|
| Addition | v1.0 and beta | For findMeetingTimes, added new enum value unrestricted that you specify as the activityDomain property, part of the timeConstraint parameter. This lets findMeetingTimes look for times appropriate for the type of activity you're scheduling for. See details in the request body section. |
| Addition | Beta | Support getting an event body in plain text, as an alternative to the default HTML format. See get and list events for details. |
| Change type | Version | Description |
|---|---|---|
| Change | Beta | Support getting a message body in plain text, as an alternative to the default HTML format. See get and list events for details. |
| Change type | Version | Description | |
|---|---|---|---|
| Addition | Beta | New outlook navigation property added to user, to access Outlook tasks. | |
| Addition | Beta | New entities - outlookuser, outlookTaskGroup, outlookTaskFolder, and outlookTask - and their methods support organizing and accessing Outlook tasks. | |
| Addition | Beta | Outlook tasks support attachments (attachment, fileAttachment, itemAttachment, and referenceAttachment resources). | |
| Addition | Beta | Outlook tasks support extended properties (singleValueLegacyExtendedProperty and multiValueLegacyExtendedProperty resources). |
| Change type | Version | Description | |
|---|---|---|---|
| Addition | v1.0 | Added Planner API. New resources: plannerPlan plannerTask plannerPlanDetails plannerTaskDetails plannerBucket plannerAssignedToTaskBoardTaskFormat plannerBucketTaskBoardTaskFormat plannerProgressTaskBoardTaskFormat |
| Change type | Version | Description |
|---|---|---|
| Addition | v1.0 | The sites resource is now avaialble in the v1.0 endpoint. Added the site and siteCollection resource types. |
| Change | beta | The format of the identifier for the site resource has changed. This is a breaking change in the beta API. |
| Removed | beta | The sharePoint entity has been removed from the beta API. The functionality is now available from the sites collection. |
| Change type | Version | Description |
|---|---|---|
| Change | beta | Removed the sharepoint navigation properties. Sites are now accessed directly through the sites navigation property. Removed the fieldDefinition resource. It has been replaced by columnDefinition. Removed the siteCollectionId and siteId properties from site. Use sharepointIds instead. Removed the listItemId property from listItem. Use sharepointIds instead. Renamed the columnSet property on listItem to fields. Changed site resources to use the SharePoint hostname as part of their ID. |
| Addition | beta | Added the booleanColumn, calculatedColumn, choiceColumn, dateTimeColumn, lookupColumn, numberColumn, personOrGroupColumn, and textColumn resource types. Added the displayName property to site. Added the columns navigation property to site. Added the list and listItem navigation properties to sharedDriveItem. Added the sharepointIds property to list and listItem, and site. Added the columnDefinition resource type. |
| Change type | Version | Description |
|---|---|---|
| Change | Beta | Adminstrative unit APIs will be updated in preview (beta). The first set of changes will be applied on May 3, 2017. The changes include the following property renaming: - roleMemberInfo complex type to identity complex type for the scopedRoleMembership entity - scopedAdministratorOf navigation property to scopedRoleMemberOf for the user entity - scopedAdministrators navigation property to scopedRoleMembers for the administrativeUnit entity - scopedAdministrators navigation property to scopedMembers for the directoryRole entity |
| Change type | Version | Description |
|---|---|---|
| Change | Beta | The application and servicePrincipal APIs will be updated in preview (beta). The first set of changes will be applied on May 15, 2017. The changes include property renaming and restructuring. Some properties (such as appRoles and addIns) will not be available until the changes are completed. The changes will be released in preview (beta) prior to releasing to v1.0. |
| Change type | Version | Description |
|---|---|---|
| Addition | Beta | Added new preview capability to allow Cloud Solution Provider pre-consented applications to call Microsoft Graph, described in a new authorization topic. |
| Change type | Version | Description |
|---|---|---|
| Addition | Beta | Added new onPremises properties onPremisesDomainName, OnPremisesSamAccountName, and onPremisesUserPrincipalName to the user entity. |
| Change type | Version | Description | |
|---|---|---|---|
| Change | Beta | Added HiddenMembership as an additional value for the visibility property to the Group entity | |
| Addition | Beta | Added new Planner API. New resources: plannerPlan plannerTask plannerPlanDetails plannerTaskDetails plannerBucket plannerAssignedToTaskBoardTaskFormat plannerBucketTaskBoardTaskFormat plannerProgressTaskBoardTaskFormat |
| Change type | Version | Description |
|---|---|---|
| Addition | Beta | Added new entities: androidForWorkCompliancePolicy deviceComplianceSettingState deviceInstallState deviceManagementScript deviceManagementScriptGroupAssignment deviceManagementScriptState eBookGroupAssignment iosVppEBook managedEBook userInstallStateSummary windowsManagementApp windowsManagementAppHealthState |
| Addition | Beta | Added new complex types: dailySchedule hourlySchedule iosBookmark iosWebContentFilterAutoFilter iosWebContentFilterBase iosWebContentFilterSpecificWebsitesAccess runSchedule sharedAppleDeviceUser windows10NetworkProxyServer |
| Addition | Beta | Added the requestRemoteAssistance action on managedDevice |
| Addition | Beta | Added the cleanWindowsDevice action on managedDevice |
| Addition | Beta | Added the logoutSharedAppleDeviceActiveUser action on managedDevice |
| Addition | Beta | Added the deleteUserFromSharedAppleDevice action on managedDevice |
| Addition | Beta | Added the assign action on deviceManagementScript |
| Addition | Beta | Added the syncLicenses action on appleVolumePurchaseProgramToken |
| Addition | Beta | Added the getTopMobileApps function on mobileApp collection |
| Addition | Beta | Added the downloadApplePushNotificationCertificateSigningRequest function on applePushNotificationCertificate |
| Addition | Beta | Added the getDeviceComplianceSettingStates function on deviceManagement |
| Addition | Beta | Added the deviceConfigurationUserActivity function on reportRoot |
| Addition | Beta | Added the deviceConfigurationDeviceActivity function on reportRoot |
| Deletion | Beta | Removed the following complex types: enterpriseCloudResource windowsInformationProtectionAppRule windowsInformationProtectionAppRuleAppLockerPolicyFileTemplate windowsInformationProtectionAppRuleDesktopTemplate windowsInformationProtectionAppRuleStoreAppTemplate windowsInformationProtectionAppRuleTemplate windowsInformationProtectionCorporateNetworkLocation windowsInformationProtectionProtectedLocation windowsInformationProtectionProtectedLocationEnterpriseCloudResources windowsInformationProtectionProtectedLocationEnterpriseInternalProxyServers windowsInformationProtectionProtectedLocationEnterpriseIPv4Ranges windowsInformationProtectionProtectedLocationEnterpriseIPv6Ranges windowsInformationProtectionProtectedLocationEnterpriseNetworkDomainNames windowsInformationProtectionProtectedLocationEnterpriseProxyServers windowsInformationProtectionProtectedLocationNeutralResources |
| Change | Beta | Added the deviceSharingAllowed property to the androidGeneralDeviceConfiguration entity |
| Change | Beta | Removed the deviceSharingBlocked property from the androidGeneralDeviceConfiguration entity |
| Change | Beta | Added the minimumRequiredSdkVersion property to the defaultManagedAppProtection entity |
| Change | Beta | Added the windowsManagementAppEnabled property to the deviceAppManagement entity |
| Change | Beta | Added the notificationTemplateId property to the deviceComplianceActionItem entity |
| Change | Beta | Added the excludeGroup property to the deviceConfigurationGroupAssignment entity |
| Change | Beta | Changed the following properties on the iosCustomConfiguration entity: payloadFileName from required to optional |
| Change | Beta | Added the contentFilterSettings property to the iosDeviceFeaturesConfiguration entity |
| Change | Beta | Added the cellularBlockPersonalHotspot and passcodeBlockFingerprintModification properties to the iosGeneralDeviceConfiguration entity |
| Change | Beta | Added the minimumRequiredSdkVersion property to the iosManagedAppProtection entity |
| Change | Beta | Changed the following properties on the macOSCustomConfiguration entity: payloadFileName from required to optional |
| Change | Beta | Added the disableAppPinIfDevicePinIsSet, minimumRequiredOsVersion, minimumWarningOsVersion, minimumRequiredAppVersion and minimumWarningAppVersion properties to the managedAppProtection entity |
| Change | Beta | Added the remoteAssistanceSessionUrl, isEncrypted, model and manufacturer properties to the managedDevice entity |
| Change | Beta | Changed the following properties on the getMobileAppCount entity: bindingParameter from mobileApp to a collection of mobileApp status from a GUID to a String |
| Change | Beta | Added the vpnConfigurationId property to the mobileAppGroupAssignment entity |
| Change | Beta | Removed the fromEmailAddress property from the notificationMessageTemplate entity |
| Change | Beta | Added the excludedApps property to the officeSuiteApp entity |
| Change | Beta | Removed the excludedOfficeApps property from the officeSuiteApp entity |
| Change | Beta | Added the enabled property to the sharedPCConfiguration entity |
| Change | Beta | Added the networkProxyApplySettingsDeviceWide, networkProxyDisableAutoDetect, networkProxyAutomaticConfigurationUrl, networkProxyServer, bluetoothDeviceName, wiFiScanInterval, wirelessDisplayBlockProjectionToThisDevice, wirelessDisplayBlockUserInputFromReceiver, wirelessDisplayRequirePinForPairing, experienceBlockDeviceDiscovery, experienceBlockErrorDialogWhenNoSIM, experienceBlockTaskSwitcher, startMenuPinnedFolderDocuments, startMenuPinnedFolderDownloads, startMenuPinnedFolderFileExplorer, startMenuPinnedFolderHomeGroup, startMenuPinnedFolderMusic, startMenuPinnedFolderNetwork, startMenuPinnedFolderPersonalFolder, startMenuPinnedFolderPictures, startMenuPinnedFolderSettings, startMenuPinnedFolderVideos, startMenuAppListVisibility, startMenuHideFrequentlyUsedApps, startMenuHideRecentJumpLists, startMenuHideRecentlyAddedApps, startMenuHideRestartOptions, startMenuHideUserTile, startMenuHidePowerButton, startMenuLayoutEdgeAssetsXml, personalizationDesktopImageUrl and personalizationLockScreenImageUrl properties to the windows10GeneralConfiguration entity |
| Change | Beta | Changed the type of the following properties on the windowsMobileMSI entity: productCode from Guid to String |
| Change | Beta | Changed the following properties on the windowsPhone81AppX entity: phoneProductIdentifier from required to optional phonePublisherId from required to optional |
| Change | Beta | Changed the following properties on the windowsPhone81AppXBundle entity: appXPackageInformationList from required to optional |
| Change | Beta | Added the productKey and licenseType properties to the windowsStoreForBusinessApp entity |
| Change | Beta | Added the previewBuildSetting property to the windowsUpdateForBusinessConfiguration entity |
| Change | Beta | Added the windowsManagementApp and managedEBooks navigation properties to the deviceAppManagement entity |
| Change | Beta | Added the deviceManagementScripts, managedDeviceOverview and cloudPkiSubscriptions navigation properties to the deviceManagement entity |
| Change | Beta | Added the osMinimumVersion and osMaximumVersion properties to the deviceEnrollmentPlatformRestrictions complex type |
| Change | Beta | Added the isSharedDevice and sharedDeviceCachedUsers properties to the hardwareInformation complex type |
| Change | Beta | Changed the following properties on the omaSettingBase64 complex type: fileName from required to optional |
| Change | Beta | Changed the following properties on the omaSettingStringXml complex type: fileName from required to optional |
| Change type | Version | Description |
|---|---|---|
| Addition | Beta | Added new entities: androidForWorkApp androidForWorkAppConfigurationSchema androidForWorkSettings androidForWorkVpnConfiguration applePushNotificationCertificate complianceSettingStateSummary deviceCompliancePolicyDeviceStateSummary deviceCompliancePolicyState deviceConfigurationDeviceStateSummary deviceConfigurationState enterpriseCodeSigningCertificate iosEduDeviceConfiguration managedDeviceCertificateState managedDeviceMobileAppConfigurationDeviceSummary managedDeviceMobileAppConfigurationUserSummary mdmWindowsInformationProtectionPolicy mobileAppInstallSummary mobileAppProvisioningConfigGroupAssignment mobileThreatDefenseConnector officeSuiteApp settingStateDeviceSummary softwareUpdateStatusSummary symantecCodeSigningCertificate windowsDefenderAdvancedThreatProtectionConfiguration windowsInformationProtection windowsInformationProtectionAppLockerFile windowsInformationProtectionPolicy windowsMobileMSI |
| Addition | Beta | Added new complex types: androidForWorkAppConfigurationExample androidForWorkAppConfigurationExampleJson androidForWorkAppConfigurationSchemaItem deviceCompliancePolicySettingState deviceConfigurationSettingState deviceExchangeAccessStateSummary edgeSearchEngine edgeSearchEngineBase edgeSearchEngineCustom excludedApps iosEduCertificateSettings ipRange windowsInformationProtectionApp windowsInformationProtectionCloudResource windowsInformationProtectionCloudResourceCollection windowsInformationProtectionDesktopApp windowsInformationProtectionIPRangeCollection windowsInformationProtectionResourceCollection windowsInformationProtectionStoreApp |
| Addition | Beta | Added the requestSignupUrl action on androidForWorkSettings |
| Addition | Beta | Added the completeSignup action on androidForWorkSettings |
| Addition | Beta | Added the syncApps action on androidForWorkSettings |
| Addition | Beta | Added the unbind action on androidForWorkSettings |
| Addition | Beta | Added the assign action on iosLobAppProvisioningConfiguration |
| Addition | Beta | Added the recoverPasscode action on managedDevice |
| Addition | Beta | Added the removeApplePushNotificationCertificate action on organization |
| Addition | Beta | Added the updateMobileAppIdentifierDeployments action on iosManagedAppProtection |
| Addition | Beta | Added the updateMobileAppIdentifierDeployments action on androidManagedAppProtection |
| Addition | Beta | Added the updateMobileAppIdentifierDeployments action on targetedManagedAppConfiguration |
| Addition | Beta | Added the updateTargetedSecurityGroups action on iosManagedAppProtection |
| Addition | Beta | Added the updateTargetedSecurityGroups action on androidManagedAppProtection |
| Addition | Beta | Added the updateTargetedSecurityGroups action on windowsInformationProtection |
| Addition | Beta | Added the updateTargetedSecurityGroups action on windowsInformationProtectionPolicy |
| Addition | Beta | Added the updateTargetedSecurityGroups action on mdmWindowsInformationProtectionPolicy |
| Addition | Beta | Added the wipeManagedAppRegistrationByDeviceTag action on user |
| Addition | Beta | Added the getTopMobileApps function on mobileApp |
| Addition | Beta | Added the verifyWindowsEnrollmentAutoDiscovery function on deviceManagement |
| Deletion | Beta | Removed the following entities: appProvisioningConfigGroupAssignment defaultManagedAppConfiguration enterpriseCertificate managedDeviceMobileAppProvisioningConfigurationDeviceStatus symantecCertificate windows10WindowsInformationProtectionConfiguration |
| Deletion | Beta | Removed the following complex types: mobileAppInstallSummary windowsArchitecture windowsDeviceType |
| Change | Beta | Added the webBrowserBlockPopups property to the androidGeneralDeviceConfiguration entity |
| Change | Beta | Removed the webBrowserAllowPopups property from the androidGeneralDeviceConfiguration entity |
| Change | Beta | Added the appIdentifier property to the androidStoreApp entity |
| Change | Beta | Removed the applicationCount, failedApplicationCount and appInstallFailures properties from the appReportingOverviewStatus entity |
| Change | Beta | Added the sharedIPadMaximumUserCount and enableSharedIPad properties to the depEnrollmentProfile entity |
| Change | Beta | Added the shareTokenWithSchoolDataSyncService and lastSyncErrorCode properties to the depOnboardingSetting entity |
| Change | Beta | Added the pendingCount, successCount, errorCount, failedCount, lastUpdateDateTime and configurationVersion properties to the deviceComplianceDeviceOverview entity |
| Change | Beta | Removed the numberOfPendingDevices, numberOfSucceededDevices, numberOfErrorDevices, numberOfFailedDevices, lastUpdateTime and policyRevision properties from the deviceComplianceDeviceOverview entity |
| Change | Beta | Added the pendingCount, successCount, errorCount, failedCount, lastUpdateDateTime and configurationVersion properties to the deviceComplianceUserOverview entity |
| Change | Beta | Removed the numberOfPendingUsers, numberOfSucceededUsers, numberOfErrorUsers, numberOfFailedUsers, lastUpdateTime and policyRevision properties from the deviceComplianceUserOverview entity |
| Change | Beta | Added the pendingCount, successCount, errorCount, failedCount, lastUpdateDateTime and configurationVersion properties to the deviceConfigurationDeviceOverview entity |
| Change | Beta | Removed the numberOfPendingDevices, numberOfSucceededDevices, numberOfErrorDevices, numberOfFailedDevices, lastUpdateTime and policyRevision properties from the deviceConfigurationDeviceOverview entity |
| Change | Beta | Added the pendingCount, successCount, errorCount, failedCount, lastUpdateDateTime and configurationVersion properties to the deviceConfigurationUserOverview entity |
| Change | Beta | Removed the numberOfPendingUsers, numberOfSucceededUsers, numberOfErrorUsers, numberOfFailedUsers, lastUpdateTime and policyRevision properties from the deviceConfigurationUserOverview entity |
| Change | Beta | Added the subscriptionState property to the deviceManagement entity |
| Change | Beta | Added the managedEmailProfileRequired property to the iosCompliancePolicy entity |
| Change | Beta | Added the appsSingleAppModeList property to the iosGeneralDeviceConfiguration entity |
| Change | Beta | Removed the appsSingleAppModeBundleIds property from the iosGeneralDeviceConfiguration entity |
| Change | Beta | Added the expirationDateTime property to the iosLobAppProvisioningConfiguration entity |
| Change | Beta | Removed the expiration property from the iosLobAppProvisioningConfiguration entity |
| Change | Beta | Added the passwordMinimumCharacterSetCount, osMinimumVersion, osMaximumVersion, deviceThreatProtectionEnabled, deviceThreatProtectionRequiredSecurityLevel and storageRequireEncryption properties to the macOSCompliancePolicy entity |
| Change | Beta | Removed the manifest property from the managedAndroidLobApp entity |
| Change | Beta | Added the isSupervised, exchangeLastSuccessfulSyncDateTime, exchangeAccessState and exchangeAccessStateReason properties to the managedDevice entity |
| Change | Beta | Added the deviceExchangeAccessStateSummary property to the managedDeviceOverview entity |
| Change | Beta | Removed the manifest property from the managedIOSLobApp entity |
| Change | Beta | Removed the installSummary property from the mobileApp entity |
| Change | Beta | Added the uploadState property to the mobileAppContentFile entity |
| Change | Beta | Changed the following properties on the mobileAppContentFile entity: azureStorageUriExpirationDateTime from required to optional |
| Change | Beta | Added the initiatedByUserPrincipalName, deviceOwnerUserPrincipalName, deviceIMEI and actionState properties to the remoteActionAudit entity |
| Change | Beta | Added the oneDriveDisableFileSync, safeSearchFilter, edgeSearchEngine, settingsBlockSettingsApp, settingsBlockSystemPage, settingsBlockDevicesPage, settingsBlockNetworkInternetPage, settingsBlockPersonalizationPage, settingsBlockAccountsPage, settingsBlockTimeLanguagePage, settingsBlockEaseOfAccessPage, settingsBlockPrivacyPage, settingsBlockUpdateSecurityPage, experienceBlockWindowsSpotlight, experienceBlockWindowsTips, experienceBlockConsumerSpecificFeatures, startMenuLayoutXml, startMenuMode, logonBlockFastUserSwitching and startBlockUnpinningAppsFromTaskbar properties to the windows10GeneralConfiguration entity |
| Change | Beta | Added the allowPrinting, allowScreenCapture and allowTextSuggestion properties to the windows10SecureAssessmentConfiguration entity |
| Change | Beta | Removed the blockPrinting, blockScreenCapture and blockTextSuggestion properties from the windows10SecureAssessmentConfiguration entity |
| Change | Beta | Added the identityName property to the windowsAppX entity |
| Change | Beta | Changed the type of the following properties on the windowsAppX entity: applicableArchitectures from windowsArchitecture to String |
| Change | Beta | Added the identityName property to the windowsPhone81AppX entity |
| Change | Beta | Changed the type of the following properties on the windowsPhone81AppX entity: applicableArchitectures from windowsArchitecture to String |
| Change | Beta | Added the identityName, identityPublisherHash and identityResourceIdentifier properties to the windowsUniversalAppX entity |
| Change | Beta | Changed the type of the following properties on the windowsUniversalAppX entity: applicableArchitectures from windowsArchitecture to String applicableDeviceTypes from windowsDeviceType to String |
| Change | Beta | Added the restartMode property to the windowsUpdateForBusinessConfiguration entity |
| Change | Beta | Added the managedDeviceCertificateStates navigation property to the androidForWorkScepCertificateProfile entity |
| Change | Beta | Added the managedDeviceCertificateStates navigation property to the androidScepCertificateProfile entity |
| Change | Beta | Added the enterpriseCodeSigningCertificates, symantecCodeSigningCertificate, sideLoadingKeys, managedAppPolicies, iosManagedAppProtections, androidManagedAppProtections, defaultManagedAppProtections, targetedManagedAppConfigurations, mdmWindowsInformationProtectionPolicies, windowsInformationProtectionPolicies, managedAppRegistrations and managedAppStatuses navigation properties to the deviceAppManagement entity |
| Change | Beta | Removed the appReportingOverview, enterpriseCerts and symantecCert navigation properties from the deviceAppManagement entity |
| Change | Beta | Added the deviceSettingStateSummaries navigation property to the deviceCompliancePolicy entity |
| Change | Beta | Added the deviceSettingStateSummaries navigation property to the deviceConfiguration entity |
| Change | Beta | Added the termsAndConditions, androidForWorkSettings, androidForWorkAppConfigurationSchemas, applePushNotificationCertificate, softwareUpdateStatusSummary, deviceCompliancePolicyDeviceStateSummary, complianceSettingStateSummaries, deviceConfigurationDeviceStateSummaries and mobileThreatDefenseConnectors navigation properties to the deviceManagement entity |
| Change | Beta | Removed the teacherRootCertificates, teacherIdentityCertificate, studentRootCertificates and studentIdentityCertificate navigation properties from the iosEducationDeviceConfiguration entity |
| Change | Beta | Changed the type of the following properties on the iosLobAppProvisioningConfiguration entity: deviceStatuses from managedDeviceMobileAppProvisioningConfigurationDeviceStatus collection to managedDeviceMobileAppConfigurationDeviceStatus collection groupAssignments from appProvisioningConfigGroupAssignment collection to mobileAppProvisioningConfigGroupAssignment collection |
| Change | Beta | Added the managedDeviceCertificateStates navigation property to the iosScepCertificateProfile entity |
| Change | Beta | Added the managedDeviceCertificateStates navigation property to the macOSScepCertificateProfile entity |
| Change | Beta | Added the deviceConfigurationStates and deviceCompliancePolicyStates navigation properties to the managedDevice entity |
| Change | Beta | Added the deviceStatusSummary and userStatusSummary navigation properties to the managedDeviceMobileAppConfiguration entity |
| Change | Beta | Added the installSummary navigation property to the mobileApp entity |
| Change | Beta | Removed the sideLoadingKeys navigation property from the organization entity |
| Change | Beta | Added the managedDeviceCertificateStates navigation property to the windows81SCEPCertificateProfile entity |
| Change | Beta | Added the managedDeviceCertificateStates navigation property to the windowsPhone81SCEPCertificateProfile entity |
| Change | Beta | Removed the applicationId, appName, platformId, userFailures and deviceFailures properties from the appInstallationFailure complex type |
| Change | Beta | Added the displayName property to the iosHomeScreenFolderPage complex type |
| Change | Beta | Added the displayName property to the iosHomeScreenPage complex type |
| Change | Beta | Added the subjectName, description, expirationDateTime and certificate properties to the windowsInformationProtectionDataRecoveryCertificate complex type |
| Change | Beta | Removed the dataRecoveryCertificate and certificateFileName properties from the windowsInformationProtectionDataRecoveryCertificate complex type |
| Change | Beta | Added the displayName property to the windowsPackageInformation complex type |
| Change | Beta | Changed the type of the following properties on the windowsPackageInformation complex type: applicableArchitecture from windowsArchitecture to String |
| Change | Beta | Changed the following properties on the windowsPackageInformation complex type: applicableArchitecture from optional to required |
| Change type | Version | Description |
|---|---|---|
| Addition | Beta | New resource: contract |
| Change type | Version | Description |
|---|---|---|
| Addition | Beta | Added functions on domains. New entities:domain domainDnsRecord domainDnsCnameRecord domainDnsMxRecord domainDnsSrvRecord domainDnsTxtRecord domainDnsUnavailableRecord New actions:forceDeleteverify |
| Change type | Version | Description |
|---|---|---|
| Addition | Beta | Extend Microsoft Graph with application data by using schema extensions. This is supported on the following resources: administrative unit calendar event device group message organization personal contact post user See the following example: Add custom data to groups using Schema Extensions (preview) |
| Addition | Beta | Provided an alternative way to create a schema extension definition without requiring a verified .com vanity domain. See schema extensions for details. |
| Change type | Version | Description |
|---|---|---|
| Change | v1.0 and beta | Renamed former "Office 365 data extensions" as "open extensions". |
| Addition | Beta | Added resources that support open extensions: administrative unit device group organization user See the following example: Add custom data to users using open extensions (preview) |
| Change type | Version | Description |
|---|---|---|
| Addition | Beta | Added support for restoring and permanently deleting groups. New entity: directory with deleteditems navigation property. |
| Addition | Beta | New entity: Endpoint |
| Change | Beta | New endpoints navigation property on groups |
| Addition | Beta | New entity: licenseDetails |
| Change | Beta | New licensedetails navigation property on users |
| Change type | Version | Description |
|---|---|---|
| Addition | Beta | Introduced the new preview API for Office 365 Reports. You can use it to get usage reports of how people in your business are using Office 365 services. For example, you can identify who is using a service a lot and reaching quotas, or who may not need an Office 365 license at all. For more details, see report. |
| Change type | Version | Description |
|---|---|---|
| Addition | Beta | New entity: contract |
| Change type | Version | Description |
|---|---|---|
| Addition | Beta | Added new entities: androidForWorkCertificateProfileBase androidForWorkEasEmailProfileBase androidForWorkEnterpriseWiFiConfiguration androidForWorkGmailEasConfiguration androidForWorkNineWorkEasConfiguration androidForWorkPkcsCertificateProfile androidForWorkScepCertificateProfile androidForWorkTrustedRootCertificate androidForWorkWiFiConfiguration appleDeviceFeaturesConfigurationBase appProvisioningConfigGroupAssignment deviceComplianceUserOverview deviceConfigurationUserOverview enterpriseCertificate iosEducationDeviceConfiguration macOSDeviceFeaturesConfiguration managedAndroidLobApp managedDeviceMobileAppProvisioningConfigurationDeviceStatus managedIOSLobApp managedMobileLobApp symantecCertificate windowsAppX windowsCertificateProfileBase windowsPhone81AppX windowsPhone81AppXBundle windowsPhoneXAP windowsUniversalAppX |
| Addition | Beta | Added new complex types: airPrintDestination windowsArchitecture windowsDeviceType windowsMinimumOperatingSystem windowsPackageInformation |
| Addition | Beta | Added the assign action on the iosLobAppProvisioningConfiguration entity |
| Addition | Beta | Added the scheduleActionsForRules action on the deviceCompliancePolicy entity |
| Addition | Beta | Added the updateTargetedSecurityGroups action on the targetedManagedAppConfiguration entity |
| Addition | Beta | Added the getScopesForUser function on the resourceOperation entity |
| Change | Beta | Removed the manifest property from the androidLobApp entity |
| Change | Beta | Added the assetTagTemplate, lockScreenFootnote, homeScreenDockIcons and homeScreenPages properties to the iosDeviceFeaturesConfiguration entity |
| Change | Beta | Removed the deviceSharingAssetTagInformation, deviceSharingLockScreenFootnote, homeScreenLayoutDockIcons and homeScreenLayoutPages properties from the iosDeviceFeaturesConfiguration entity |
| Change | Beta | Added the appsSingleAppModeBundleIds property to the iosGeneralDeviceConfiguration entity |
| Change | Beta | Removed the manifest property from the iosLobApp entity |
| Change | Beta | Added the createdDateTime, description, lastModifiedDateTime, displayName and version properties to the iosLobAppProvisioningConfiguration entity |
| Change | Beta | Added the createdDateTime and lastModifiedDateTime properties to the managedAppPolicy entity |
| Change | Beta | Removed the deviceRegistrationState property from the managedDevice entity |
| Change | Beta | Added the manifest property to the mobileAppContentFile entity |
| Change | Beta | Added the osDescription and userName properties to the mobileAppInstallStatus entity |
| Change | Beta | Removed the deviceType property from the mobileAppInstallStatus entity |
| Change | Beta | Changed the type of the following properties on the mobileAppInstallStatus entity: mobileAppInstallStatusValue from Int32 to String |
| Change | Beta | Added the targetedSecurityGroupIds and targetedSecurityGroupsCount properties to the targetedManagedAppConfiguration entity |
| Change | Beta | Removed the numberOfTargetedSecurityGroups property from the targetedManagedAppConfiguration entity |
| Change | Beta | Added the id property to the user entity |
| Change | Beta | Removed the renewalThresholdPercentage, keyStorageProvider, subjectNameFormat, subjectAlternativeNameType, certificateValidityPeriodValue and certificateValidityPeriodScale properties from the windows10CertificateProfileBase entity |
| Change | Beta | Removed the renewalThresholdPercentage, keyStorageProvider, subjectNameFormat, subjectAlternativeNameType, certificateValidityPeriodValue and certificateValidityPeriodScale properties from the windows81CertificateProfileBase entity |
| Change | Beta | Removed the applyToWindows10Mobile property from the windowsPhone81GeneralConfiguration entity |
| Change | Beta | Added the enterpriseCerts, iosLobAppProvisioningConfigurations and symantecCert navigation properties to the deviceAppManagement entity |
| Change | Beta | Added the userStatusOverview navigation property to the deviceCompliancePolicy entity |
| Change | Beta | Added the userStatusOverview navigation property to the deviceConfiguration entity |
| Change | Beta | Added the groupAssignments, deviceStatuses and userStatuses navigation properties to the iosLobAppProvisioningConfiguration entity |
| Change | Beta | Changed the type of the following properties on the windows10VpnConfiguration entity: identityCertificate from windows10CertificateProfileBase to windowsCertificateProfileBase |
| Change | Beta | Added the deviceComplianceCheckinThresholdDays and isScheduledActionEnabled properties to the deviceManagementSettings complex type |
| Change | Beta | Removed the windowsCommercialId and windowsCommercialIdLastModifiedTime properties from the deviceManagementSettings complex type |
| Change | Beta | Added the bundleID, appName, publisher, enabled and showOnLockScreen properties to the iosNotificationSettings complex type |
| Change | Beta | Removed the bundleIdentifier, notificationsEnabled and showInLockScreen properties from the iosNotificationSettings complex type |
| Change type | Version | Description |
|---|---|---|
| Addition | v1.0 | New action findMeetingTimes for the user resource. |
| Addition | v1.0 | New complex type attendeeBase which consists of a type property for the attendee type. |
| Addition | v1.0 | New complex types: attendeeAvailability locationConstraint locationConstraintItem meetingTimeSuggestion meetingTimeSuggestionsResult timeConstraint timeSlot |
| Change | v1.0 | The attendee complex type is now derived from attendeeBase, which in turn is derived from recipient. Including the inherited properties, it consists of the same status, type and emailAddress properties as before. |
| Addition | Beta | hexColor added to the calendar resource. |
| Change type | Version | Description |
|---|---|---|
| Addition | Beta | Added new entities: appReportingOverviewStatus deviceComplianceDeviceOverview deviceConfigurationDeviceOverview deviceManagementExchangeOnpremisesPolicy iosDeviceFeaturesConfiguration iosEducationDeviceConfiguration iosLobAppProvisioningConfiguration onpremisesConditionalAccessSettings sharedPCConfiguration windows10EnterpriseModernAppManagementConfiguration windows10SecureAssessmentConfiguration windows10WindowsInformationProtectionConfiguration |
| Addition | Beta | Added new complex types: appInstallationFailure enterpriseCloudResource iosHomeScreenApp iosHomeScreenFolder iosHomeScreenFolderPage iosHomeScreenItem iosHomeScreenPage iosNotificationSettings iPv6Range sharedPCAccountManagerPolicy windowsInformationProtectionAppRule windowsInformationProtectionAppRuleAppLockerPolicyFileTemplate windowsInformationProtectionAppRuleDesktopTemplate windowsInformationProtectionAppRuleStoreAppTemplate windowsInformationProtectionAppRuleTemplate windowsInformationProtectionCorporateNetworkLocation windowsInformationProtectionDataRecoveryCertificate windowsInformationProtectionProtectedLocation windowsInformationProtectionProtectedLocationEnterpriseCloudResources windowsInformationProtectionProtectedLocationEnterpriseInternalProxyServers windowsInformationProtectionProtectedLocationEnterpriseIPv4Ranges windowsInformationProtectionProtectedLocationEnterpriseIPv6Ranges windowsInformationProtectionProtectedLocationEnterpriseNetworkDomainNames windowsInformationProtectionProtectedLocationEnterpriseProxyServers windowsInformationProtectionProtectedLocationNeutralResources |
| Deletion | Beta | Removed the following complex types and replaced with microsoft.graph.Json: managedAppDeploymentSummary managedAppSummary |
| Change | Beta | Replaced the property type appConfigComplianceStatus with complianceStatus on the following entities: managedDeviceMobileAppConfigurationDeviceStatus managedDeviceMobileAppConfigurationUserStatus |
| Change | Beta | For resource managedAppStatusRaw, changed type of property content from managedAppSummary to Json. |
| Change | Beta | Removed the getUsersWithFlaggedAppRegistration function from the managedAppRegistration collection. |
| Change | Beta | Changed the vppToken navigation property of the iosVppApp entity to no longer be a contained collection. |
| Change | Beta | Added the deviceStatusOverview property to the deviceConfiguration and deviceCompliancePolicy entities. |
| Change | Beta | Added the appReportingOverview property to the deviceAppManagement singleton. |
| Change | Beta | Added the deviceDisplayName and userPrincipalName properties to the deviceConfigurationDeviceStatus, deviceComplianceDeviceStatus and managedDeviceMobileAppConfigurationDeviceStatus entities. |
| Change | Beta | Add the ruleName property to the deviceComplianceScheduledActionForRule entity. |
| Change | Beta | Added the devicesCount, userDisplayName and userPrincipalName properties to the deviceConfigurationUserStatus, deviceComplianceUserStatus, and managedDeviceMobileAppConfigurationUserStatus entities. |
| Change | Beta | Added the notificationMessageTemplates collection to the deviceManagement singleton. |
| Change | Beta | Added the isDefault, lastModifiedDateTime, locale, messageTemplate and subject properties to thelocalizedNotificationMessage entity. |
| Change | Beta | Added the azureActiveDirectoryDeviceId, deviceCategory, deviceRegistrationState and managementAgent properties to the managedDevice entity. |
| Change | Beta | Added the lastModifiedDateTime property to the mobileAppCategory entity. |
| Change | Beta | Added the brandingOptions, defaultLocale, displayName, fromEmailAddress, lastModifiedDateTime, localizedNotificationMessages properties to the notificationMessageTemplate entity. |
| Change | Beta | Added the appsAllowTrustedAppsSideloading, appsBlockWindowsStoreOriginatedApps, developerUnlockSetting, edgeBlockAccessToAboutFlags, edgeBlockDeveloperTools, edgeBlockExtensions, edgeBlockInPrivateBrowsing, edgeFirstRunUrl, edgeHomepageUrls, gameDvrBlocked, settingsBlockAddProvisioningPackage, settingsBlockChangeLanguage, settingsBlockChangePowerSleep, settingsBlockChangeRegion, settingsBlockChangeSystemTime, settingsBlockEditDeviceName, settingsBlockRemoveProvisioningPackage, sharedUserAppDataAllowed, smartScreenBlockPromptOverride, smartScreenBlockPromptOverrideForFiles, storageRestrictAppDataToSystemVolume, storageRestrictAppInstallToSystemVolume, webRtcBlockLocalhostIpAddress, windowsStoreBlockAutoUpdate and windowsStoreEnablePrivateStoreOnly properties to the windows10GeneralConfiguration entity. |
| Change type | Version | Description |
|---|---|---|
| Addition | Beta | A new delta function add to the following entities to perform delta query: contact contactFolder event group mailFolder message user See the following for examples: Get incremental changes to groups (preview) Get incremental changes to messages in a folder (preview) Get incremental changes to users (preview) |
| Change type | Version | Description |
|---|---|---|
| Addition | v1.0 | Added workbookPivotTable resource, refresh and refreshAll action on pivotTables, workbookRangeView resource, visibleView action on the filtered range to return workbookRangeView to the user, get rows collection and range resource off of visibleView, columnsAfter, columnsBefore, resizedRange, rowsAbove, and rowsBelow functions off of range resource, and new table properties. |
| Change type | Version | Description |
|---|---|---|
| Addition | Beta | Added resources and method APIs for Microsoft Intune. This is a large set of resources and methods to support the public preview of Intune on Azure Portal. For information about the Intune service, see the Intune documentation. For information about the Intune resources and APIs, see Working with Intune in Microsoft Graph. |
| Change type | Version | Description |
|---|---|---|
| Addition | v1.0 and beta | The v2.0 auth endpoint now supports the client_credentials OAuth grant, which can be used for daemon & long running processes in business scenarios. |
| Addition | v1.0 and beta | The v2.0 auth endpoint now supports permission scopes that require administrator's consent, via the admin consent endpoint. |
| Addition | v1.0 and beta | The v2.0 auth endpoint now supports administrative consent for all users in a tenant, via the admin consent endpoint. |
| Change type | Version | Description |
|---|---|---|
| Addition | Beta | Added invitedUserType property to the invitation entity type, that defines the type of user (Guest or Member) that is invited. |
| Deletion | Beta | We will be removing the invitedToGroups property from the invitation entity-type on 11/11/2016. This means that you will no longer be able to add an invited user to a group using this API. Instead, use the add member API to add a user to a group. |
| Change type | Version | Description |
|---|---|---|
| Addition | Beta | Azure AD Application Proxy APIs are now available in the Microsoft Graph beta endpoint. These APIs allow for secure publishing of on-premises applications to users outside the corporate network using Azure AD as the common control plane for access. You can use the published APIs to write applications that can retrieve and update various aspects of application proxy, such as connectors, connectorGroups and the onPremisesPublishing settings of an application. |
| Change type | Version | Description |
|---|---|---|
| Addition | Beta | Added shared collection to allow accessing shared driveItems by shareId or sharing URL. |
| Addition | Beta | Added search function to a drive, which allows searching for more items than just those in the drive's root folder. |
| Change type | Version | Description |
|---|---|---|
| Addition | Beta | Added support for createUploadSession, which allows uploading files larger than 4 MB to OneDrive, OneDrive for Business, and SharePoint document libraries. |
| Addition | Beta | Added sharepointIds property to driveItem that returns traditional SharePoint API identifiers for driveItems stored in SharePoint. |
| Addition | Beta | Added additional properties on remoteItem. |
| Addition | Beta | Added the quickXorHash value for files in OneDrive for Business. |
| Addition | Beta | Added scope to the createSharingLink to allow creating company sharable links or anonymous sharing links. |
| Change type | Version | Description |
|---|---|---|
| Addition | v1.0 | Extended properties are now supported by the following resources: message, mailFolder, event, calendar, contact, contactFolder, group event, group calendar, group post. |
Added support for dynamic group membership through the public preview API, including the additions listed in the following table.
| Change type | Version | Description |
|---|---|---|
| Addition | Beta | Added membershipRule property contains rules that controls the memberships for this group, if the group is a dynamic group. |
| Addition | Beta | Added membershipRuleProcessingState property to control whether dynamic membership processing is on or paused for this group. |
| Addition | Beta | Set the groupTypes property to contain "DynamicMembership" to light up the dynamic groups capability for this group. |
| Addition | Beta | Added preferredLanguage property to indicate the preferred language for an Office 365 group. |
| Addition | Beta | Added theme property to specify an Office 365 group's color theme. |
| Change type | Version | Description |
|---|---|---|
| Addition | v1.0 | Apps can use v1.0 Outlook Mail, Calendar, and Contacts APIs to access on-premises mailboxes in a hybrid deployment with Exchange 2016 Cumulative Update 3 (CU3). Find more details about REST API support in specific hybrid deployments. Note: If you're using these sets of API in v1.0, you can now find your apps, including production apps, working for on-premises mailboxes that meet the specific hybrid deployment requirements. This capability is only in preview. |
| Change type | Version | Description |
|---|---|---|
| Change | Beta | As part of the schema change where the type of two location properties is being replaced by a new complex type in the identityRiskEvents endpoint, the following properties are changed/added in the identityRiskEvents endpoint: location changed from Edm.String to ComplexType signInLocation. previousLocation changed from Edm.String to ComplexType signInLocation. signInLocation new ComplexType that contains city, state, countryOrRegion and geoCoordinates properties. geoCoordinates new ComplexType that contains latitude and longitude properties. |
| Change type | Version | Description |
|---|---|---|
| Addition | Beta | Invitation manager APIs are now available in the Microsoft Graph beta endpoint. You can use invitation manager APIs to create an invite, in order to add an external user to the organization. As part of the invitation, you can also choose to add the invited user to an Office 365 group. For more details, see invitation manager. |
| Change type | Version | Description |
|---|---|---|
| Addition | v1.0 | Added CreateUploadSession method on driveItem, which allows large file and resumable uploads. |
| Addition | v1.0 | Added properties for tracking SharePoint IDs on items from SharePoint (sharepointIds) and a property to identify root folders (root). |
| Addition | v1.0 | Added Shares root collection, which can be used with shareIds or sharing links to access shared items in OneDrive and SharePoint. Returns a new type, sharedDriveItem. |
| Addition | v1.0 | Added Invite method on driveItem, which allows adding permissions to items. |
| Addition | v1.0 | Added Search method on drive, which allows searching across items in the drive and shared items. |
| Addition | v1.0 | Added processingMetadata property on file complex type quickXorHash property on hashes complex type. |
| Addition | v1.0 | Added quickXorHash property on hashes complex type. |
| Change type | Version | Description |
|---|---|---|
| Addition | v1.0 | Added the onlineMeetingUrl property to the event resource. |
| Addition | Beta | Added forward action to the event resource. |
| Addition | Beta | Added the following properties to the calendar resource to support calendar sharing: canEdit, canShare, canViewPrivateItems, isShared, isShareWithMe, and owner. |
| Change type | Version | Description |
|---|---|---|
| Addition | v1.0 | Added the mailboxSettings complex type, which includes the automaticRepliesSetting, timeZone, and language properties. |
| Addition | v1.0 | Added the mailboxSettings property to the user resource. |
| Addition | Beta | Added support for creating, listing, getting, and deleting one or more instances of mention in a message. Mentions support calling out to get the attention of other users in a message. |
| Addition | Beta | Added support for the getMailTips action to get any MailTips for specific recipients. Added the following resources: automaticRepliesMailTips, mailTips, mailTipsError. |
| Change type | Version | Description |
|---|---|---|
| Change | Beta | Query parameters without $ prefixes are supported as of 09/26/16. The $ prefix in query parameters is optional. For details, see the Supporting query parameters without $ prefixes in Microsoft Graph blog post. |
| Change type | Version | Description |
|---|---|---|
| Addition | Beta | Access to SharePoint sites and lists by ID or path/URL. |
| Addition | Beta | Support for listing, creating, getting, and deleting instances of listItem. |
| Change type | Version | Description |
|---|---|---|
| Addition | Beta | Added refreshTokensValidFromDateTime read-only property to indicate when refresh or session tokens are valid from. Any tokens issued before this time are invalid, and any attempt to use them would force a new sign-in for the user. |
| Addition | Beta | Added showInAddressList property to control if the Outlook global address list should contain this user. |
| Addition | Beta | Added invalidateAllRefreshTokens service action that invalidates all of the user's refresh and session tokens issued to applications, by resetting the refreshTokensValidFromDateTime user property to the current date-time. |
| Change type | Version | Description |
|---|---|---|
| Addition | Beta | Added Drive root items to Webhooks as a resource that is available to subscribe to. |
| Change type | Version | Description |
|---|---|---|
| Addition | Beta | As part of the schema change where a few properties are being removed and corresponding collections are being added to contacts endpoint, the following properties have been added to the contacts endpoint: Websites Collection(ComplexType: Website),_Phones Collection (ComplexType: Phone)_, PostalAddress Collection(ComplexType: PhysicalAddress). For details, see the Upcoming changes to Contacts and People APIs blog post. |
| Deletion | Beta | As part of the schema change where a few properties are being removed and corresponding collections are being added to contacts endpoint, the following properties have been removed from the contacts endpoint: BusinessHomePage,_HomePhones_, MobilePhone1, BusinessPhones, HomeAddress, BusinessAddress, OtherAddress. For details, see the Upcoming changes to Contacts and People APIs blog post. |
| Change type | Version | Description |
|---|---|---|
| Addition | v1.0 | Excel REST API on Microsoft Graph is generally available. Now you can build rich and deep integrations with Excel workbooks in Office 365. See the Power your apps with the new Excel REST API on the Microsoft Graph blog post for more details. |
| Change type | Version | Description |
|---|---|---|
| Change | Beta | Property WebSite is renamed to Websites. For details, see Upcoming changes to Contacts and People APIs. |
| Change type | Version | Description |
|---|---|---|
| Addition | Beta | Privileged Identity Management (PIM) REST APIs now are available in the Microsoft Graph beta endpoint. Privileged Identity Management provides just in time activation for privileged Azure AD organizational roles such as Global Administrator, Billing Administrator, and so on. You can use the published APIs to write applications that retrieve and update privileged role assignments, and activate users into roles. For details, see Microsoft Graph: Azure AD Privileged Identity Management Preview APIs available in Beta and Azure AD Privileged Identity Management. |
| Change type | Version | Description |
|---|---|---|
| Addition | Beta | Introduced the new Administrative Unites preview API. Administrative units allow organizations to subdivide their Azure Active Directory, and delegate administrative duties to those subdivisions. Subdivisions can represent regions, departments, cost centers, etc. This can now be managed through the Microsoft Graph API. |
| Change type | Version | Description |
|---|---|---|
| Addition | Beta | Introduced the new IdentityRiskEvents preview API. This API works in conjunction with Azure Active Directory Identity Protection. You can use it to query risk events generated by Identity Protection. For more details, see the Introduction of a new preview API to Microsoft Graph: IdentityRiskEvents blog post. |
| Change type | Version | Description |
|---|---|---|
| Addition | Beta | App-only scopes are now supported for mail and contacts subscriptions. |
| Change type | Version | Description |
|---|---|---|
| Breaking change | Beta | Changes to the findMeetingTimes API. For more information, see the Microsoft Graph findMeetingTimes API update blog post. This change took effect May 19th, 2016. |
| Change type | Version | Description |
|---|---|---|
| Addition | v1.0 | Added extensions, which is abstract type to support the OData v4 open type openTypeExtension. |
| Change type | Version | Description |
|---|---|---|
| Breaking change | Beta | settingTemplateId is renamed to templateId. This change will take effect May 19th, 2016. |
| Change type | Version | Description |
|---|---|---|
| Addition | v1.0 | Added extensions, which is abstract type to support the OData v4 open type openTypeExtension. |
| Change type | Version | Description |
|---|---|---|
| Addition | v1.0 | Added inferenceClassification and extensions to eventMessages. |
| Addition | Beta | Added responseRequested to eventMessageRequest. |
| Change type | Version | Description | |
|---|---|---|---|
| Addition | v1.0 | Added inferenceClassification and extensions to messages. | |
| Addition | Beta | Added wellknownname to contactFolder. | Changes to findMeetingTimes API. For more information, see the Microsoft Graph findMeetingTimes API update blog post. This change will take effect May 19th, 2016. |
| Change type | Version | Description |
|---|---|---|
| Addition | v1.0 | Added extensions, which is abstract type to support the OData v4 open type openTypeExtension. |
| Change type | Version | Description |
|---|---|---|
| Addition | v1.0 | Added inferenceClassification resource type. |
| Addition | Beta | Added timeZone to mailboxsettings. |
| Addition | Beta | Added API _findMeetingTimes_to user. |
| Change type | Version | Description |
|---|---|---|
| Addition | v1.0 and Beta | Added support for honoring Accept-Encoding:gzip. |
| Addition | v1.0 | Added support for cast segment in expand path. For example, 'https://graph.microsoft.com/v1.0/me/messages?$expand=microsoft.graph.eventMessage/event'. |
| Addition | Beta | Added support for PATCH request against structural properties. For example: 'PATCH /me/mailboxSettings'. |
| Addition | Beta | Azure Active Directory is now used as a fallback for /beta/users/id/photo requests when Outlook is unable to service the request, for example when the user has no mailbox license or the tenant does not have an Exchange Online subscription. NOTE: this fallback is available for both GET and PATCH. |
| Addition | Beta | Added support for cast segment in expand path. For example: 'https://graph.microsoft.com/v1.0/me/messages?$expand=microsoft.graph.eventMessage/event'. |
| Change type | Version | Description |
|---|---|---|
| Fix | v1.0 | Fixed the issue that OneDrive createLink requests failing with 500 and "Unsupported extension property type." |
| Change type | Version | Description |
|---|---|---|
| Addition | Beta | Added singleValueExtendedProperties and multiValueExtendedProperties properties. |
| Addition | Beta | Added suggestionHint property to meetingTimeCandidate. |
| Addition | Beta | Added locationUri property to location. |
| Addition | Beta | Added type and postOfficeBox to physicalAddress. |
| Change | Beta | findMeetingTimes now takes new parameter ReturnSuggestionHints. |
| Change | Beta | findMeetingTimes now returns a collection of meetingTimeCandidate. |
| Change type | Version | Description |
|---|---|---|
| Addition | v1.0 and beta | Added recent function to list a set of items that have been recently used by the signed in user. This list includes items that are in the user's drive as well as items they have access tofrom other drives. Example: GET /me/drive/recent. |
| Addition | v1.0 and beta | Added sharedWithMe function to list the set of items that are shared with the current user. Example: GET /me/drive/sharedWithMe. |
| Change type | Version | Description |
|---|---|---|
| Addition | v1.0 and beta | Added remoteItem type to provide a link to an item in another drive. |
| Addition | v1.0 and beta | Added sharingInvitation type to provide details of any associated sharing invitation for this permission. |
| Addition | v1.0 and beta | Added delta function to track changes to items in a drive. Example: GET /me/drive/items/{item-id}/delta |
| Addition | v1.0 and beta | Added copy that creates a copy of a driveItem (including any children), under a new parent or with a new name. Example: POST /me/drive/items/{item-id}/copy. |
| Addition | v1.0 and beta | conflictBehavior instance attributes is now applicable to driveItem. |
| Addition | Beta | Added invite function to send a sharing invitation to an existing item. A sharing invitation creates a unique sharing link and sends an email to the recipient of the invitation that includes the sharing link. Example: POST /drive/items/{item-id}/invite. |
| Change type | Version | Description |
|---|---|---|
| Addition | Beta | Added new property onlineMeetingUrl and new method cancel. |
| Change type | Version | Description |
|---|---|---|
| Addition | Beta | Added startDateTime, endDateTime, location, type, recurrence, isOutOfDate, conversationIndex, unsubscribe, unsubscribeData, unsubscribeEnabled and flag properties to eventmessage object. |
| Addition | Beta | Added singleValueExtendedProperties and multiValueExtendedProperties properties. |
| Addition | Beta | Added new method unsubscribe. |
| Change type | Version | Description |
|---|---|---|
| Addition | Beta | We are adding new Excel REST APIs that let you read and modify data in an Excel workbook. It is now possible to build smart apps that allows users to get value out of the content stored in an Excel workbook by providing insights into the data. Take advantage of analytical powers of Excel, create tables and charts and extract visually appealing chart image - all from within your app. For details, see Working with Excel in Microsoft Graph. |
| Change type | Version | Description |
|---|---|---|
| Addition | v1.0 and beta | Improved error message when resolving tenant alias and rejected JWT (AAD) tokens. |
| Addition | v1.0 and beta | The location of the authorization service endpoint is now returned in the www-authenticate header when a request is received with an empty bearer token. |
| Addition | v1.0 and beta | The ability to filter on an entity's id property is now fixed. Example: GET https://graph.microsoft.com/v1.0/users?$filter=id+eq+'x' Previously, any POST requests to service actions and functions require prefixing the action or function name with the microsoft.graph prefix. For example: POST https://graph.microsoft.com/v1.0/me/Microsoft.Graph.getMemberGroups. The prefix is now no longer required (although it can still be specified). So the following would now also work: POST https://graph.microsoft.com/v1.0/me/getMemberGroups. |
| Change | Beta | Cleaned up subscription property names. |
| Addition | Beta | We've added the capability to discover (through directorySettingTemplates) and override the default behavior (by creating a setting from the template) for entities and their associated functionality. Initially this only template provided is to control behaviors on Office groups. |
| Change type | Version | Description |
|---|---|---|
| Addition | Beta | Added wellKnownName and userConfigurations properties. |
| Addition | Beta | Added singleValueExtendedProperties and multiValueExtendedProperties properties |
| Change type | Version | Description |
|---|---|---|
| Addition | v1.0 | Added mobilePhone property. |
| Addition | v1.0 and beta | Added internetMessageId property. The message ID in the format specified by RFC2822. |
| Change | Beta | Renamed mobilePhone1 property to mobilePhone. |
| Change | Beta | createReply and _createReplyAll_take new parameter Message and comment. |
| Change | Beta | createForward takes new parameter Message, ToRecipients and comment. |
| Change | Beta | reply, replyAll and forward take new parameter Message. |
| Change type | Version | Description |
|---|---|---|
| Addition | v1.0 and beta | Added sharingInvitation property to provide details of any associated sharing invitation for this permission. |
| Change type | Version | Description |
|---|---|---|
| Addition | Beta | Added new properties birthday, personNotes, isFavorite, phones, permission, postalAddresses,_websites,_yomiCompany, department, profession, mailboxType and personType. |
| Addition | Beta | Added new enum types physicalAddressType, webSite, phone and webSiteType. |
| Change type | Version | Description |
|---|---|---|
| Addition | Beta | Added new properties sourceUrl, providerType, thumbnailUrl, previewUrl, permission and isFolder. |
| Addition | Beta | Added singleValueExtendedProperties and multiValueExtendedProperties properties. |
| Addition | Beta | Added new enum types referenceAttachmentProvider and referenceAttachmentPermission. |
| Change type | Endpoint | Description |
|---|---|---|
| Addition | v1.0 | Webhooks are now GA on V1.0 endpoint via the /Subscriptions resource. Create, Read, Renew and Delete subscriptions to receive notifications on data from Outlook and Office 365 group conversations. |
| Change type | Version | Description |
|---|---|---|
| Addition | Beta | Added mailboxSettings property and corresponding types. |
| Change type | Version | Description |
|---|---|---|
| Addition | v1.0 and beta | New remoteItem property on driveItem for Microsoft accounts. |
| Change type | Version | Description |
|---|---|---|
| Change | v1.0 and beta | -/me/drive now works for both Microsoft accounts and Work and School accounts. |
| Change | v1.0 and beta | Drive requests for accounts whose OneDrive storage was provisioned on demand work more reliably and work in more scenarios where tenant default SharePoint sites use non-standard names. |
| Deletion | Beta | Removed various unimplemented types from the beta schema to more closely match the 1.0 schema. |
| Change type | Version | Description |
|---|---|---|
| Addition | Beta | notificationUrl validation on subscription creation. For details, see Microsoft Graph WebHooks Update - January 2016. |
| Addition | Beta | Subscription entities can now be deleted: DELETE https://graph.microsoft.com/beta/subscriptions/ |
| Change type | Version | Description |
|---|---|---|
| Change | v1.0 and beta | displayName is now returned for Microsoft accounts. |
| Change type | Version | Description |
|---|---|---|
| Addition | v1.0 | Added mobilePhone property to personal contacts entity-set. |
| Change type | Version | Description |
|---|---|---|
| Fix | v1.0 and beta | Fixed calling actions that are bound to directoryObjects, which were failing with the following error: The return type from the operation is not possible with the given entity set. This applies to the following actions: microsoft.graph.checkMemberObjects, microsoft.graph.getMemberObjects, microsoft.graph.checkMemberGroups, microsoft.graph.assignLicense, microsoft.graph.changePassword. |
| Change type | Version | Description |
|---|---|---|
| Addition | Beta | Added mobilePhone property to personal contacts entity-set. |
| Change type | Version | Description |
|---|---|---|
| Fix | v1.0 and beta | Fixed requests using $filter expressions that specified the same property more than once, which were failing with the following 500 error: An item with the same key has already been added. |
| Fix | v1.0 and beta | Fixed case insensitivity for action parameter names and values. |
| Fix | v1.0 and beta | Fixed request processing for payloads containing null values for some embedded complex properties, which were failing with a null reference exception. |
| Addition | v1.0 and beta | Added support for complex type property sorting and filtering. |
| Addition | v1.0 and beta | Added authorization_uri property in the www-authenticate header on a 401 response. This uri can be used to start the token acquisition flow. |
| Addition | v1.0 and beta | Improved error messages across users and groups. |
| Change type | Version | Description |
|---|---|---|
| Fix | v1.0 and beta | Fixed calling the following group actions: microsoft.graph.addFavorite, microsoft.graph.removeFavorite and microsoft.graph.resetUnseenCount. |
| Change type | Version | Description |
|---|---|---|
| Addition | Beta | Added eventMessageRequest subtype of eventMessage and startDateTime, endDateTime, location, type, recurrence and isOutOfDate properties to eventMessage type. |
| Change type | Version | Description |
|---|---|---|
| Fix | v1.0 and beta | Fixed being able to select certain user properties on other users, when referencing the user by user principal name (UPN). For example: https://graph.microsoft.com/v1.0/users/[email protected]?$select=aboutMe |
| Fix | v1.0 and beta | Fixed calling the microsoft.graph.reminderView user bound function, which was failing with the following error: Could not find a property named businessPhones on type Microsoft.OutlookServices.Reminder. |
| Fix | v1.0 and beta | Fixed user creation and update (POST/PATCH /v1.0/users), which was failing with a 400 error. |
