{"id":1604,"date":"2015-10-09T17:52:27","date_gmt":"2015-10-09T17:52:27","guid":{"rendered":"https:\/\/developer.microsoft.com\/en-us\/office\/blogs\/?p=1604"},"modified":"2015-10-09T17:52:27","modified_gmt":"2015-10-09T17:52:27","slug":"outlook-rest-api-changes-to-beta-endpoint","status":"publish","type":"post","link":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/outlook-rest-api-changes-to-beta-endpoint\/","title":{"rendered":"Outlook REST API changes to beta endpoint"},"content":{"rendered":"<p>We are making a few changes to the Office 365 REST APIs beta endpoint. The changes are being rolled out in pre-prod and production systems and will be widely deployed over the next few weeks.<\/p>\n<h2>User ID changed<\/h2>\n<p>The <code>User<\/code> entity&#8217;s <code>Id<\/code> property will start returning a new format: <code>{AAD User Id}@{AAD Tenant id}<\/code> instead of the user&#8217;s SMTP address.<\/p>\n<pre><code> {\n \u00a0\u00a0...\n \u00a0\u00a0@odata.id: \"https:\/\/outlook.office365.com\/api\/beta\/Users('9607a528-7230-43d2-bb04-b2e576eafba5@2dc87bd3-88ff-4b99-b7ba-618c973e93ea')\",\n \u00a0\u00a0Id: \"9607a528-7230-43d2-bb04-b2e576eafba5@2dc87bd3-88ff-4b99-b7ba-618c973e93ea\"\n \u00a0\u00a0EmailAddress: \"rohitag@contoso.com\",\n \u00a0\u00a0DisplayName: \"Rohit Nagarmal\",\n \u00a0\u00a0Alias: \"rohitag\",\n \u00a0\u00a0...\n } \n <\/code><\/pre>\n<p>Note that we are also adding the <code>EmailAddress<\/code> property to <code>User<\/code> that contains the SMTP address that used to be in <code>Id<\/code>.<\/p>\n<p>The request to find a user will continue to allow specifying an SMTP in addition to the new id format. So both of these requests are valid:<\/p>\n<pre><code> GET https:\/\/outlook.office365.com\/api\/beta\/users\/rohitag@contoso.com<\/code><\/pre>\n<p>GET https:\/\/outlook.office365.com\/api\/beta\/users\/9607a528-7230-43d2-bb04-b2e576eafba5@2dc87bd3-88ff-4b99-b7ba-618c973e93ea<\/p>\n<pre><code><\/code><\/pre>\n<p>With this change, we have made the API more consistent with our Groups API where the ID always returned in the <code>{AAD User Id}@{AAD Tenant id}<\/code> format.<\/p>\n<h2>IsContactPhoto property removed<\/h2>\n<p>We have removed the <code>IsContactPhoto<\/code> property from the <code>FileAttachment<\/code> entity.<\/p>\n<p>Hopefully this was something that you were not using anyways, but if you had your clients deserialize the <code>FileAttachment<\/code> object and were reading this property, you will have to update the code to remove references to it.<\/p>\n<h2>Name changes<\/h2>\n<p>We are making changes to entity names and property names to avoid naming conflict and confusion when we expose the Outlook entities in the Office 365 Unified API.<\/p>\n<ul>\n<li><code>Folder<\/code> entity renamed to <code>MailFolder<\/code><\/li>\n<li><code>Folders<\/code> property on <code>User<\/code> entity renamed to <code>MailFolders<\/code><\/li>\n<li><code>DatetimeLastModfied<\/code> renamed to <code>LastModifiedDateTime<\/code><\/li>\n<li><code>DateTimeCreated<\/code> renamed to <code>CreatedDateTime<\/code><\/li>\n<li><code>DateTimeReceived<\/code> renamed to <code>ReceivedDateTime<\/code><\/li>\n<li><code>DateTimeSent<\/code> renamed to <code>SentDateTime<\/code><\/li>\n<li><code>DateTimeLastDelivered<\/code> renamed to <code>LastDeliveredDateTime<\/code><\/li>\n<\/ul>\n<p>Please stay tuned, we are also making updates related to timezones and reminders in calendar events. We will have a separate post on these changes very soon.<\/p>\n","protected":false},"excerpt":{"rendered":"<p>We are making a few changes to the Office 365 REST APIs beta endpoint. The changes are being rolled out in pre-prod and production systems and will be widely deployed over the next few weeks.<\/p>\n","protected":false},"author":69077,"featured_media":25159,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"footnotes":""},"categories":[3],"tags":[12],"class_list":["post-1604","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-microsoft-graph","tag-outlook"],"acf":[],"blog_post_summary":"<p>We are making a few changes to the Office 365 REST APIs beta endpoint. The changes are being rolled out in pre-prod and production systems and will be widely deployed over the next few weeks.<\/p>\n","_links":{"self":[{"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/posts\/1604","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/users\/69077"}],"replies":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/comments?post=1604"}],"version-history":[{"count":0,"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/posts\/1604\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/media\/25159"}],"wp:attachment":[{"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/media?parent=1604"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/categories?post=1604"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/tags?post=1604"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}