Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
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.
Represents the aggregated work location state for a user, computed from multiple signals: scheduled, automatic, and manual. It provides a consistent, privacy-aware way to indicate where a user works (for example, office, remote, or time off) and includes metadata that supports hybrid work scenarios.
- Precedence: manual > automatic > scheduled
- Precision: more granular wins (for example, office + building > office)
Aggregation rules
- If manual location is set, it takes precedence immediately.
- Otherwise, if an automatic location exists, the most precise automatic signal wins.
- Otherwise, if a scheduled location exists, it's used as a fallback.
- If none exist, source = none; workLocationType =
unspecified.
Properties
| Property | Type | Description |
|---|---|---|
| placeId | String | Identifier of the place (when applicable). |
| source | workLocationSource | Indicates which layer wins the aggregation. The possible values are: none, manual, scheduled, automatic, unknownFutureValue. |
| workLocationType | workLocationType | Semantic type of the location. The possible values are: unspecified, office, remote, timeOff, unknownFutureValue. |
Relationships
None.
JSON representation
The following JSON representation shows the resource type.
{
"@odata.type": "#microsoft.graph.userWorkLocation",
"placeId": "String",
"source": "String",
"workLocationType": "String"
}