---
title: WindowsAutoUpdateSettings type | Wartiva GraphQL API
description: Configuration that controls how the endpoint downloads and installs Windows updates. Wartiva GraphQL API reference with arguments, fields, and examples.
url: https://wartiva.com/api-docs/types/windows-auto-update-settings.html
updated: 2026-10-07
---

Applications and updates · GraphQL type

# `WindowsAutoUpdateSettings` type

Configuration that controls how the endpoint downloads and installs Windows updates. Many of these fields reflect settings normally configured by an administrator through Group Policy or Windows Update for Business. A `null` value means the agent could not read that particular setting on this endpoint.

## Fields

| Field Name | Description |
|---|---|
| `notificationLevel` - [`WindowsUpdateNotificationLevel`](https://wartiva.com/api-docs/types/windows-update-notification-level.html) | How the endpoint behaves when new updates are available — from "do nothing" through fully automated downloads and scheduled installs. See [WindowsUpdateNotificationLevel](https://wartiva.com/api-docs/types/windows-update-notification-level.html). |
| `readOnly` - [`Boolean`](https://wartiva.com/api-docs/types/boolean.html) | Whether the user of the endpoint is prevented from changing the update settings. When `true`, the configuration is locked down — typically because an administrator has enforced it through policy. When `false`, the user may have changed it. |
| `required` - [`Boolean`](https://wartiva.com/api-docs/types/boolean.html) | Whether Automatic Updates is mandated for this endpoint by administrative policy. When `true`, the service cannot be turned off locally even by an administrator. |
| `scheduledInstallationDay` - [`WindowsScheduledInstallationDay`](https://wartiva.com/api-docs/types/windows-scheduled-installation-day.html) | Day of the week on which scheduled installations run. Only meaningful when `notificationLevel` is `SCHEDULED_INSTALL`. See [WindowsScheduledInstallationDay](https://wartiva.com/api-docs/types/windows-scheduled-installation-day.html). |
| `scheduledInstallationHour` - [`Int`](https://wartiva.com/api-docs/types/int.html) | Hour of the day (0–23, local time on the endpoint) at which scheduled installations run. Only meaningful when `notificationLevel` is `SCHEDULED_INSTALL`. For example, a value of `3` means installs start at 03:00 local time. |
| `includeRecommendedUpdates` - [`Boolean`](https://wartiva.com/api-docs/types/boolean.html) | Whether the endpoint includes optional / recommended updates in addition to required security updates. When `true`, the endpoint downloads driver updates and other recommended improvements alongside required ones. |
| `featuredUpdatesEnabled` - [`Boolean`](https://wartiva.com/api-docs/types/boolean.html) | Whether the endpoint surfaces featured updates promoted by Microsoft. Rarely used on modern Windows versions and typically `false`; included for completeness. |
| `nonAdministratorsElevated` - [`Boolean`](https://wartiva.com/api-docs/types/boolean.html) | Whether standard (non-administrator) users may approve and install updates without administrator elevation. When `true`, standard users can install updates themselves; when `false`, an administrator must approve. |

## Used by

- [`SoftwareUpdatePreferencesWindows`](https://wartiva.com/api-docs/types/software-update-preferences-windows.html) type: Windows-specific software update preferences and the list of updates the endpoint has discovered but has not yet installed.

## Example

### Example

```json
{
  "notificationLevel": "NOT_CONFIGURED",
  "readOnly": false,
  "required": true,
  "scheduledInstallationDay": "EVERY_DAY",
  "scheduledInstallationHour": 987,
  "includeRecommendedUpdates": true,
  "featuredUpdatesEnabled": false,
  "nonAdministratorsElevated": true
}

```

---

Wartiva is in early access. Request access: https://wartiva.com/early-access.html  
All pages: https://wartiva.com/llms.txt