Share via

Changes to collections and recurrence in REST API

  • Article

I 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.

Scope of collections

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 already returns all the messages of the user across all his mail folders, not just Inbox.

Similarly, we are making a change to the ../contacts, ../contactfolders and ../mailfolders endpoint.

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

Change to recurrence range

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

Old Recurrence

 Recurrence: { 
 Pattern: { 
 Type: "Daily", 
 Interval: 1, 
 Month: 0, 
 DayOfMonth:0, 
 FirstDayOfWeek: "Sunday", 
 Index: "First" 
 }, 
 Range: { 
 Type: "EndDate", 
 StartDate: "2015-11-09T00:00:00Z", 
 EndDate: "2015-12-09T00:00:00Z",
 NumberOfOccurrences: 0 
 }
}

New Recurrence

 Recurrence: { 
 Pattern: { 
 Type: "Daily", 
 Interval: 1, 
 Month: 0, 
 DayOfMonth:0, 
 FirstDayOfWeek: "Sunday", 
 Index: "First" 
 }, 
 RecurrenceTimeZone: “Pacific Standard Time”, 
 Range: { 
 Type: "EndDate", 
 StartDate: "2015-11-09", 
 EndDate: "2015-12-09", 
 NumberOfOccurrences: 0 
 } 
}

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 https://dev.outlook.com for the latest news and updates.

Comments

  • Anonymous
    January 07, 2016
    Great content. Thanks for article.

  • Anonymous
    January 11, 2016
    The comment has been removed

  • Anonymous
    January 26, 2016
    Hey Rohit, Is there any REST API available to get Exchage online users attributes? There is a powershell interface available for exchange online but couldn't find any REST api

  • Anonymous
    February 05, 2016
    The comment has been removed