{"id":1600,"date":"2015-11-06T17:22:05","date_gmt":"2015-11-06T17:22:05","guid":{"rendered":"https:\/\/developer.microsoft.com\/en-us\/office\/blogs\/?p=1600"},"modified":"2015-11-06T17:22:05","modified_gmt":"2015-11-06T17:22:05","slug":"changes-to-collections-and-recurrence-in-rest-api","status":"publish","type":"post","link":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/changes-to-collections-and-recurrence-in-rest-api\/","title":{"rendered":"Changes to collections and recurrence in REST API"},"content":{"rendered":"

We wanted to give an update on some more breaking changes that we are making to the Outlook REST API beta endpoint. These changes will be widely deployed over the next few weeks.<\/p>\n

Scope of collections<\/h2>\n

We are making it consistent across the Outlook REST APIs to return all items of a given type from its top level collections. For example ..\/me\/messages<\/code> already returns all the messages of the user across all his mail folders, not just Inbox.<\/p>\n

Similarly, we are making a change to the ..\/contacts<\/code>, ..\/contactfolders<\/code> and ..\/mailfolders<\/code> endpoint.<\/p>\n

    \n
  1. \/Contacts<\/code> endpoint will start returning all the contacts in the signed-in user\u2019s mailbox. Prior to this change you would only see contacts from the default contacts folder of the user.<\/li>\n
  2. \/ContactFolders<\/code> will return all ContactFolders in the signed-in user\u2019s mailbox, irrespective of how deeply they are nested.<\/li>\n
  3. \/MailFolders<\/code> will also start returning all MailFolders in the signed-in user\u2019s mailbox. Prior to this change \/MailFolders<\/code> would return folders only from the root folder of the user.<\/li>\n<\/ol>\n

    Change to recurrence range<\/h2>\n

    In the RecurrenceRange<\/code> complex type (which is used in recurring meetings), we are changing the type for the StartDate<\/code> and EndDate<\/code> properties from DateTime<\/code> to Date<\/code>. There is also a new property in the Recurrence <\/code>complex type, RecurrenceTimeZone<\/code>, which reflects the timezone for StartDate<\/code> and EndDate<\/code> properties.<\/p>\n

    Old Recurrence<\/code><\/h3>\n
    Recurrence: { \n Pattern: { \n Type: \"Daily\", \n Interval: 1, \n Month: 0, \n DayOfMonth:0, \n FirstDayOfWeek: \"Sunday\", \n Index: \"First\" \n }, \n Range: { \n Type: \"EndDate\", \n StartDate: \"2015-11-09T00:00:00Z\", \n EndDate: \"2015-12-09T00:00:00Z\",\n NumberOfOccurrences: 0 \n }\n}<\/code><\/pre>\n
    New Recurrence<\/code><\/h3>\n
    Recurrence: { \n Pattern: { \n Type: \"Daily\", \n Interval: 1, \n Month: 0, \n DayOfMonth:0, \n FirstDayOfWeek: \"Sunday\", \n Index: \"First\" \n }, \n RecurrenceTimeZone: \u201cPacific Standard Time\u201d, \n Range: { \n Type: \"EndDate\", \n StartDate: \"2015-11-09\", \n EndDate: \"2015-12-09\", \n NumberOfOccurrences: 0 \n } \n}<\/code><\/pre>\n
    More extensive documentation on the new functionality is coming soon in our API reference documentation page. Please let us know if you have any questions, and visit http:\/\/dev.outlook.com<\/a> for the latest news and updates.<\/p>\n","protected":false},"excerpt":{"rendered":"
    We wanted to give an update on some more breaking changes that we are making to the Outlook REST API beta endpoint. These changes 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-1600","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-microsoft-graph","tag-outlook"],"acf":[],"blog_post_summary":"
    We wanted to give an update on some more breaking changes that we are making to the Outlook REST API beta endpoint. These changes will be widely deployed over the next few weeks.<\/p>\n","_links":{"self":[{"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/posts\/1600","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=1600"}],"version-history":[{"count":0,"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/posts\/1600\/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=1600"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/categories?post=1600"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/tags?post=1600"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}