workHoursAndLocationsSetting resource type

Namespace: microsoft.graph

Represents a user's working hours and location preferences for modern hybrid work scenarios.

Work hours and location information are useful in scenarios that involve planning in-office days with colleagues and scheduling meetings across different working hours and time zones. You can get and update a user's work hours and locations. Use these APIs to set different work locations and schedules to accommodate flexible work arrangements.

Methods

Method	Return Type	Description
Get	workHoursAndLocationsSetting	Get the properties and relationships of a user's workHoursAndLocationsSetting.
Update	workHoursAndLocationsSetting	Update the properties of a user's workHoursAndLocationsSetting.
Occurrences view	workPlanOccurrence collection	Get work plan occurrences from a user's work plan within a specified date range.
List recurrences	workPlanRecurrence collection	Get the recurrences from a user's work plan via the recurrences navigation property.
Create recurrence	workPlanRecurrence	Create a new workPlanRecurrence object in a user's work plan.
Create occurrence	workPlanOccurrence	Create a new workPlanOccurrence object in a user's work plan.

Properties

Property	Type	Description
maxSharedWorkLocationDetails	maxWorkLocationDetails	Controls the level of work location details that can be shared with colleagues. The possible values are: unknown, none, approximate, specific, unknownFutureValue.

maxWorkLocationDetails values

Member	Description
unknown	The level of location details to share is unknown. This value exists for backward compatibility only and can't be set as a new value.
none	No location details are shared.
approximate	Only general work location type is shared, such as office or remote.
specific	Detailed location information is shared, such as building and desk information.
unknownFutureValue	Evolvable enumeration sentinel value. Don't use.

Relationships

Relationship	Type	Description
occurrences	workPlanOccurrence collection	Collection of work plan occurrences.
recurrences	workPlanRecurrence collection	Collection of recurring work plans defined by the user.

JSON representation

The following JSON representation shows the resource type.

{
  "maxSharedWorkLocationDetails": "String"
}