workhoursandlocationssetting.md

title	workHoursAndLocationsSetting resource type
description	Represents your working hours and location preferences for modern hybrid work scenarios.
author	emilbekj
ms.localizationpriority	medium
ms.subservice	outlook
doc_type	resourcePageType
ms.date	12/19/2025

workHoursAndLocationsSetting resource type

Namespace: microsoft.graph

Represents your 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 your work hours and locations as part of your personal work planning. Use these APIs to set different work locations and schedules to accommodate your flexible work arrangements.

Methods

Method	Return Type	Description
Get	workHoursAndLocationsSetting	Get the properties and relationships of your own workHoursAndLocationsSetting.
Update	workHoursAndLocationsSetting	Update the properties of your own workHoursAndLocationsSetting.
Occurrences view	workPlanOccurrence collection	Get work plan occurrences from your own work plan within a specified date range.
List recurrences	workPlanRecurrence collection	Get the recurrences from your own work plan via the recurrences navigation property.
Create recurrence	workPlanRecurrence	Create a new workPlanRecurrence object in your own work plan.
Create occurrence	workPlanOccurrence	Create a new workPlanOccurrence object in your own 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"
}