# Microsoft Entra ID (formerly Azure AD) Users.user Settings API

**Canonical:** https://apis.io/apis/azure-ad/azure-ad-users-usersettings-api/  
**Provider:** Microsoft Entra ID (formerly Azure AD) — https://apis.io/providers/azure-ad/  
**Base URL:** https://login.microsoftonline.com  
**Documentation:** https://learn.microsoft.com/en-us/azure/active-directory-b2c/

Microsoft Entra ID (formerly Azure AD) Users.user Settings API is one of 186 APIs that [Microsoft Entra ID (formerly Azure AD)](https://apis.io/providers/azure-ad/) 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, API documentation, authentication docs, and a changelog.

The users.userSettings API from Microsoft Entra ID (formerly Azure AD) — 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 (7)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/azure-ad/refs/heads/main/openapi/azure-ad-users-usersettings-api-openapi.yml
- **Documentation** — https://learn.microsoft.com/en-us/graph/api/overview
- **Authentication** — https://learn.microsoft.com/en-us/graph/auth/
- **SDKs** — https://learn.microsoft.com/en-us/graph/sdks/sdks-overview
- **ChangeLog** — https://developer.microsoft.com/en-us/graph/changelog
- **Webhooks** — https://raw.githubusercontent.com/api-evangelist/azure-ad/refs/heads/main/asyncapi/azure-ad-change-notifications-webhooks.yml
- **Documentation** — https://learn.microsoft.com/en-us/graph/change-notifications-overview

## Other Microsoft Entra ID (formerly Azure AD) APIs (12)

- [Azure AD B2C API](https://apis.io/apis/azure-ad/azure-ad-b2c-api/)
- [Microsoft Entra ID (formerly Azure AD) Admin.people Admin Settings API](https://apis.io/apis/azure-ad/azure-ad-admin-peopleadminsettings-api/)
- [Microsoft Entra ID (formerly Azure AD) Agreements.agreement API](https://apis.io/apis/azure-ad/azure-ad-agreements-agreement-api/)
- [Microsoft Entra ID (formerly Azure AD) Agreements.agreement Acceptance API](https://apis.io/apis/azure-ad/azure-ad-agreements-agreementacceptance-api/)
- [Microsoft Entra ID (formerly Azure AD) Agreements.agreement File API](https://apis.io/apis/azure-ad/azure-ad-agreements-agreementfile-api/)
- [Microsoft Entra ID (formerly Azure AD) Agreements.agreement File Localization API](https://apis.io/apis/azure-ad/azure-ad-agreements-agreementfilelocalization-api/)
- [Microsoft Entra ID (formerly Azure AD) Applications API](https://apis.io/apis/azure-ad/azure-ad-applications-api/)
- [Microsoft Entra ID (formerly Azure AD) Applications.application.Actions API](https://apis.io/apis/azure-ad/azure-ad-applications-application-actions-api/)
- [Microsoft Entra ID (formerly Azure AD) Applications.application API](https://apis.io/apis/azure-ad/azure-ad-applications-application-api/)
- [Microsoft Entra ID (formerly Azure AD) Applications.application.Functions API](https://apis.io/apis/azure-ad/azure-ad-applications-application-functions-api/)
- [Microsoft Entra ID (formerly Azure AD) Applications.app Management Policy API](https://apis.io/apis/azure-ad/azure-ad-applications-appmanagementpolicy-api/)
- [Microsoft Entra ID (formerly Azure AD) Applications.directory Object API](https://apis.io/apis/azure-ad/azure-ad-applications-directoryobject-api/)

---

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