Changelog for Microsoft Graph

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

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

May 2017

Application API changes

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

Remove Deprecated Planner API

Change type Version Description
Deletion Beta Removed the following entities:
task
plan
bucket

taskDetails
planDetails
taskBoardTaskFormat

planTaskBoard

Project Rome

Change type Version Description
Addition Beta Added support for Project Rome, including getting a list of devices, sending a command to a device, and checking the status of a command.

Administrative units property changes

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

Add users and groups webhook support in preview

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

Add delta query to v1.0

Change type Version Description
Addition v1.0 Add delta function support to V1.0. Add to the following entities to perform delta query:
contact
contactFolder
event
group
mailFolder
message
user
See the following for examples:
Get incremental changes to groups
Get incremental changes to messages in a folder
Get incremental changes to users
Change Beta Add additional optional query filtering capability (by id) to users and groups.

Added user resource support for deleted items

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

Added OnPremisesProvisioningError

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

Added deletedDateTime property

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

Added domain operations to v1.0

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

Added contracts to v1.0

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

Added licenseDetails to v1.0

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

Drive API

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

Extensions (open extensions)

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

Extensions (schema extensions)

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

Group

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

Insights APIs

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

Intune APIs

Change type Version Description
Addition Beta Added new entities:
androidForWorkMobileAppConfiguration
cartToClassAssociation
deviceCompliancePolicySettingStateSummary
eBookInstallSummary
eBookVppGroupAssignment
iosUpdateConfiguration
remoteAssistancePartner
windows10EndpointProtectionConfiguration
windowsDeviceMalwareState
windowsInformationProtectionAppLearningSummary
windowsMalwareInformation
windowsProtectionState
Addition Beta Added new complex types:
androidPermissionAction
bitLockerSystemDrivePolicy
defenderDetectedMalwareActions
settingSource
Addition Beta Added the assign action on managedEBook
Addition Beta Added the beginOnboarding action on remoteAssistancePartner
Addition Beta Added the disconnect action on remoteAssistancePartner
Deletion Beta Removed the following entities:
outlookTask
outlookTaskFolder
outlookTaskGroup

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

Outlook calendar

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

Outlook mail

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

Outlook tasks

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

Planner APIs

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

SharePoint sites

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

SharePoint Lists

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

April 2017

Administrative units property changes

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

Application and servicePrincipal API changes

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

Added preview support for Cloud Solution Provider developers

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

Added onPremises properties to user entity

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

New Planner APIs and an update to the group visibility property

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

Intune APIs

Change type Version Description
Addition Beta Added new entities:
androidForWorkCompliancePolicy
deviceComplianceSettingState
deviceInstallState
deviceManagementScript
deviceManagementScriptGroupAssignment
deviceManagementScriptState
eBookGroupAssignment
iosVppEBook
managedEBook
userInstallStateSummary
windowsManagementApp
windowsManagementAppHealthState
Addition Beta Added new complex types:
dailySchedule
hourlySchedule