# Microsoft 365 Users.user Settings API

**Canonical:** https://apis.io/apis/microsoft-365/microsoft-365-users-usersettings-api/  
**Provider:** Microsoft 365 — https://apis.io/providers/microsoft-365/  
**Base URL:** https://graph.microsoft.com/v1.0/  
**Documentation:** https://learn.microsoft.com/en-us/graph/overview

Microsoft 365 Users.user Settings API is one of 103 APIs that [Microsoft 365](https://apis.io/providers/microsoft-365/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. The published artifact set on APIs.io includes an OpenAPI specification.

The users.userSettings API from Microsoft 365 — 24 operation(s) for users.usersettings.

## Operations (50)

| Method | Path | Summary |
|---|---|---|
| GET | `/users/{user-id}/settings` | Get settings from users |
| PATCH | `/users/{user-id}/settings` | Update the navigation property settings in users |
| DELETE | `/users/{user-id}/settings` | Delete navigation property settings for users |
| GET | `/users/{user-id}/settings/exchange` | List Exchange settings |
| GET | `/users/{user-id}/settings/itemInsights` | Get itemInsights from users |
| PATCH | `/users/{user-id}/settings/itemInsights` | Update userInsightsSettings |
| DELETE | `/users/{user-id}/settings/itemInsights` | Delete navigation property itemInsights for users |
| GET | `/users/{user-id}/settings/shiftPreferences` | Get shiftPreferences |
| PATCH | `/users/{user-id}/settings/shiftPreferences` | Update shiftPreferences |
| DELETE | `/users/{user-id}/settings/shiftPreferences` | Delete navigation property shiftPreferences for users |
| GET | `/users/{user-id}/settings/storage` | Get storage from users |
| PATCH | `/users/{user-id}/settings/storage` | Update the navigation property storage in users |
| DELETE | `/users/{user-id}/settings/storage` | Delete navigation property storage for users |
| GET | `/users/{user-id}/settings/storage/quota` | Get quota from users |
| PATCH | `/users/{user-id}/settings/storage/quota` | Update the navigation property quota in users |
| DELETE | `/users/{user-id}/settings/storage/quota` | Delete navigation property quota for users |
| GET | `/users/{user-id}/settings/storage/quota/services` | Get services from users |
| POST | `/users/{user-id}/settings/storage/quota/services` | Create new navigation property to services for users |
| GET | `/users/{user-id}/settings/storage/quota/services/{serviceStorageQuotaBreakdown-id}` | Get services from users |
| PATCH | `/users/{user-id}/settings/storage/quota/services/{serviceStorageQuotaBreakdown-id}` | Update the navigation property services in users |
| DELETE | `/users/{user-id}/settings/storage/quota/services/{serviceStorageQuotaBreakdown-id}` | Delete navigation property services for users |
| GET | `/users/{user-id}/settings/storage/quota/services/$count` | Get the number of the resource |
| GET | `/users/{user-id}/settings/windows` | Get windows from users |
| POST | `/users/{user-id}/settings/windows` | Create new navigation property to windows for users |
| GET | `/users/{user-id}/settings/windows/{windowsSetting-id}` | Get windows from users |
| PATCH | `/users/{user-id}/settings/windows/{windowsSetting-id}` | Update the navigation property windows in users |
| DELETE | `/users/{user-id}/settings/windows/{windowsSetting-id}` | Delete navigation property windows for users |
| GET | `/users/{user-id}/settings/windows/{windowsSetting-id}/instances` | Get instances from users |
| POST | `/users/{user-id}/settings/windows/{windowsSetting-id}/instances` | Create new navigation property to instances for users |
| GET | `/users/{user-id}/settings/windows/{windowsSetting-id}/instances/{windowsSettingInstance-id}` | Get instances from users |
| PATCH | `/users/{user-id}/settings/windows/{windowsSetting-id}/instances/{windowsSettingInstance-id}` | Update the navigation property instances in users |
| DELETE | `/users/{user-id}/settings/windows/{windowsSetting-id}/instances/{windowsSettingInstance-id}` | Delete navigation property instances for users |
| GET | `/users/{user-id}/settings/windows/{windowsSetting-id}/instances/$count` | Get the number of the resource |
| GET | `/users/{user-id}/settings/windows/$count` | Get the number of the resource |
| GET | `/users/{user-id}/settings/workHoursAndLocations` | Get workHoursAndLocations from users |
| PATCH | `/users/{user-id}/settings/workHoursAndLocations` | Update the navigation property workHoursAndLocations in users |
| GET | `/users/{user-id}/settings/workHoursAndLocations/microsoft.graph.occurrencesView(startDateTime='{startDateTime}',endDateTime='{endDateTime}')` | Invoke function occurrencesView |
| GET | `/users/{user-id}/settings/workHoursAndLocations/occurrences` | Get occurrences from users |
| POST | `/users/{user-id}/settings/workHoursAndLocations/occurrences` | Create new navigation property to occurrences for users |
| GET | `/users/{user-id}/settings/workHoursAndLocations/occurrences/{workPlanOccurrence-id}` | Get occurrences from users |
| PUT | `/users/{user-id}/settings/workHoursAndLocations/occurrences/{workPlanOccurrence-id}` | Update the navigation property occurrences in users |
| DELETE | `/users/{user-id}/settings/workHoursAndLocations/occurrences/{workPlanOccurrence-id}` | Delete navigation property occurrences for users |
| GET | `/users/{user-id}/settings/workHoursAndLocations/occurrences/$count` | Get the number of the resource |
| POST | `/users/{user-id}/settings/workHoursAndLocations/occurrences/microsoft.graph.setCurrentLocation` | Invoke action setCurrentLocation |
| GET | `/users/{user-id}/settings/workHoursAndLocations/recurrences` | Get recurrences from users |
| POST | `/users/{user-id}/settings/workHoursAndLocations/recurrences` | Create new navigation property to recurrences for users |
| GET | `/users/{user-id}/settings/workHoursAndLocations/recurrences/{workPlanRecurrence-id}` | Get recurrences from users |
| PUT | `/users/{user-id}/settings/workHoursAndLocations/recurrences/{workPlanRecurrence-id}` | Update the navigation property recurrences in users |
| DELETE | `/users/{user-id}/settings/workHoursAndLocations/recurrences/{workPlanRecurrence-id}` | Delete navigation property recurrences for users |
| GET | `/users/{user-id}/settings/workHoursAndLocations/recurrences/$count` | Get the number of the resource |

## Machine-readable artifacts (1)

- **OpenAPI** — https://artifacts.apis.io/microsoft-365/openapi/microsoft-365-users-usersettings-api-openapi.yml

## Other Microsoft 365 APIs (12)

- [Microsoft Graph API](https://apis.io/apis/microsoft-365/graph-api/)
- [Microsoft Graph Beta API](https://apis.io/apis/microsoft-365/graph-beta-api/)
- [Microsoft 365 Calendar API](https://apis.io/apis/microsoft-365/microsoft-365-calendar-api/)
- [Microsoft 365 Files API](https://apis.io/apis/microsoft-365/microsoft-365-files-api/)
- [Microsoft 365 Groups API](https://apis.io/apis/microsoft-365/microsoft-365-groups-api/)
- [Microsoft 365 Mail API](https://apis.io/apis/microsoft-365/microsoft-365-mail-api/)
- [Microsoft 365 Me API](https://apis.io/apis/microsoft-365/microsoft-365-me-api/)
- [Microsoft 365 Teams API](https://apis.io/apis/microsoft-365/microsoft-365-teams-api/)
- [Microsoft 365 Users API](https://apis.io/apis/microsoft-365/microsoft-365-users-api/)
- [Microsoft MCP Server for Enterprise](https://apis.io/apis/microsoft-365/mcp-server-enterprise/)
- [Microsoft 365 App Catalogs.teams App API](https://apis.io/apis/microsoft-365/microsoft-365-appcatalogs-teamsapp-api/)
- [Microsoft 365 Chats.chat.Actions API](https://apis.io/apis/microsoft-365/microsoft-365-chats-chat-actions-api/)

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/microsoft-365/microsoft-365-users-usersettings-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/microsoft-365/.