meetingTimeSuggestionsResult resource type

Namespace: microsoft.graph

Important

APIs under the /beta version in Microsoft Graph are subject to change. Use of these APIs in production applications is not supported. To determine whether an API is available in v1.0, use the Version selector.

A collection of meeting suggestions if there is any, and the reason if there isn't.

The following are the possible reasons that findMeetingTimes does not return any meeting suggestions.

emptySuggestionsReason value Reasons
attendeesUnavailable All of the attendees' availability is known, but not enough attendees are available to reach the meeting confidence threshold, which is 50% by default, for any time period.
attendeesUnavailableOrUnknown Some or all of the attendees have unknown availability, causing the meeting confidence to fall below the set threshold, which is 50% by default. Attendee availability can become unknown if the attendee is outside of the organization, or there is an error obtaining free/busy information.
locationsUnavailable The isRequired property of the locationConstraint parameter is specified as true, and yet there are no locations available at the calculated time slots.
organizerUnavailable The isOrganizerOptional parameter is false and yet the organizer is not available during the requested time window.
unknown The reason for not returning any meeting suggestions is not known.

Properties

Property Type Description
emptySuggestionsReason String A reason for not returning any meeting suggestions. Possible values are: attendeesUnavailable, attendeesUnavailableOrUnknown, locationsUnavailable, organizerUnavailable, or unknown. This property is an empty string if the meetingTimeSuggestions property does include any meeting suggestions.
meetingTimeSuggestions meetingTimeSuggestion collection An array of meeting suggestions.

Relationships

None.

JSON representation

The following JSON representation shows the resource type.

{
  "emptySuggestionsReason": "String",
  "meetingTimeSuggestions": [{"@odata.type": "microsoft.graph.meetingTimeSuggestion"}]
}