Changes to collections and recurrence in REST API


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

Comments (4)

  1. https://getpocket.com/@ofismobilyalari says:

    Great content. Thanks for article.

  2. Paula C says:

    I got this in an e-mail this morning but I am afraid to click the

    IMPORTANT MAIL UPDATE,

    Dear Customer:

    Note:

    Your e-mail account will expire at the end of the month. In other to remain active, Use the following link to update your account

    login.live.com/login.srf

    Thank you for using Outlook Account. link…I don't need a virus. Is this for real?

  3. Sagar says:

    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

  4. alanramani. says:

    wrongwrightstuff4zoe4y06dhouormeI

    isclesand thumbnails &learnmore are bookmark tapes.in red,green,gold,white and cherry.

Skip to main content