Changelog for Microsoft Graph

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

March 2017

Add custom data to Microsoft Graph using schema extensions

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

Add custom data to Microsoft Graph using open extensions

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

Directory APIs

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

Reports APIs

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

February 2017

Intune APIs

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

January 2017

Outlook calendar

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

Intune APIs

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

December 2016

Delta query

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

Excel APIs

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

Intune APIs

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

October 2016

Authorization provider

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

Invitation APIs

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

September 2016

Azure AD application proxy

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

Drive

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

??

DriveItem

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

Extended properties

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

Groups

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

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

Hybrid deployment support

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

IdentityRiskEvents

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

Invitation manager

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

OneDrive

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

Outlook calendar

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

Outlook mail

Change type Version Description
Addition v1.0 Added the mailboxSettings??complex type, which includes the??automaticRepliesSetting, timeZone,??and??language??properties.
Addition v1.0 Added the mailboxSettings??property to the??user??resource.
Addition Beta Added support for creating, listing, getting, and deleting one or more instances of??mention??in a message. Mentions support calling out to get the attention of other users in a message.
Addition Beta Added support for the??getMailTips??action to get any MailTips for specific recipients. Added the following resources:??automaticRepliesMailTips, mailTips, mailTipsError.

Query parameters

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

SharePoint

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

Users

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

Webhooks

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

August 2016

Contacts

Change type Version Description
Addition Beta As part of the schema change where a few properties are being removed and corresponding collections are being added to contacts endpoint, the following properties have been added to the contacts endpoint:??_Websites ??? Collection(ComplexType: Website),_Phones ??? Collection (ComplexType: Phone),??_PostalAddress ??? Collection(ComplexType: PhysicalAddress)_. For details, see??the Upcoming changes to Contacts and People APIs blog post.
Deletion Beta As part of the schema change where a few properties are being removed and corresponding collections are being added to contacts endpoint, the following properties have been removed from the contacts endpoint:??_BusinessHomePage,_HomePhones,??_MobilePhone1,??_BusinessPhones,??_HomeAddress,??_BusinessAddress,??_OtherAddress_. For details, see??the Upcoming changes to Contacts and People APIs blog post.

Excel APIs

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

People

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

Privileged Identity Management

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

July 2016

????

Administrative Units

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

June 2016

IdentityRiskEvents

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

Subscriptions

Change type Version Description
Addition Beta App-only scopes are now supported for??_mail??and??_contacts??subscriptions.

May 2016

Calendar

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

Contact

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

Directory

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

Event

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

EventMessages

Change type Version Description
Addition v1.0 Added??_inferenceClassification??and??_extensions??to??_eventMessages_.
Addition Beta Added??_responseRequested??to??_eventMessageRequest.

Messages

Change type Version Description
Addition v1.0 Added??_inferenceClassification??and??_extensions??to??_messages_.
Addition Beta Added??_wellknownname??to??_contactFolder. Changes to??_findMeetingTimes_??API. For more information, see the??Microsoft Graph findMeetingTimes API update blog post. This change will take effect May 19th, 2016.

Post

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

User

Change type Version Description
Addition v1.0 Added??_inferenceClassification_??resource type.
Addition Beta Added??_timeZone??to??_mailboxsettings.
Addition Beta Added API??_findMeetingTimesOLD??_to??_user_.

April 2016

General

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

OneDrive

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

March 2016

Calendar

Change type Version Description
Addition Beta Added??_singleValueExtendedProperties??and??_multiValueExtendedProperties??properties.
Addition Beta Added??_suggestionHint??property to??_meetingTimeCandidate??.
Addition Beta Added??_locationUri??property to??_location.
Addition Beta Added??_type??and??_postOfficeBox??to??_physicalAddress??_.
Change Beta findMeetingTimes??now takes new parameter??_ReturnSuggestionHints_.
Change Beta findMeetingTimes??now returns a collection of??_meetingTimeCandidate_.

Drive

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

DriveItem

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

Event

Change type Version Description
Addition Beta Added new property??_onlineMeetingUrl??and new method??_cancel.

Event messages

Change type Version Description
Addition Beta Added??_startDateTime,??_endDateTime,??_location,??_type,??_recurrence,??_isOutOfDate,??_conversationIndex,??_unsubscribe,??_unsubscribeData,??_unsubscribeEnabled??and??_flag??properties to??_eventmessage??object.
Addition Beta Added??_singleValueExtendedProperties??and??_multiValueExtendedProperties??properties.
Addition Beta Added new method??_unsubscribe_.

Excel

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

General

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

Mail folder

Change type Version Description
Addition Beta Added??_wellKnownName??and??_userConfigurations??properties.
Addition Beta Added??_singleValueExtendedProperties??and??_multiValueExtendedProperties??properties

Messages

Change type Version Description
Addition v1.0 Added??_mobilePhone_??property.
Addition v1.0 and beta Added??_internetMessageId_??property. The message ID in the format specified by??RFC2822.
Change Beta Renamed??_mobilePhone1??property to??_mobilePhone.
Change Beta createReply??and??_createReplyAll??_take new parameter??_Message??and??_comment.
Change Beta createForward??_takes new parameter??_Message??,??_ToRecipients??and??_comment.
Change Beta reply,??_replyAll_and??_forward??take new parameter??_Message.

Permission

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

Person

Change type Version Description
Addition Beta Added new properties??_birthday,??_personNotes,??_isFavorite,??_phones,??_permission,??_postalAddresses,_websites,_yomiCompany,??_department,??_profession,??_mailboxType??and??_personType.
Addition Beta Added new enum types??_physicalAddressType,??_webSite??,??_phone??and??_webSiteType.

Reference attachment

Change type Version Description
Addition Beta Added new properties??_sourceUrl,??_providerType,??_thumbnailUrl,??_previewUrl,??_permission??and??_isFolder.
Addition Beta Added??_singleValueExtendedProperties??and??_multiValueExtendedProperties??properties.
Addition Beta Added new enum types??_referenceAttachmentProvider??_and??_referenceAttachmentPermission_.

Subscriptions

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

User

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

February 2016

DriveItem

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

General

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

Subscriptions

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

Users

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

January 2016

Contacts

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

directoryObjects

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

December 2015

Contacts

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

General

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

Groups

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

Messages

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

Users

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