diff --git a/docs/REST API/rest-api.md b/docs/REST API/rest-api.md index 6cd0fbfee4..282be6eafa 100644 --- a/docs/REST API/rest-api.md +++ b/docs/REST API/rest-api.md @@ -879,6 +879,10 @@ None. "minimum_version": "12.3.1", "deadline": "2022-01-01" }, + "windows_updates": { + "deadline_days": 5, + "grace_period_days": 1 + }, "macos_settings": { "custom_settings": ["path/to/profile1.mobileconfig"], "enable_disk_encryption": true @@ -1082,6 +1086,8 @@ Modifies the Fleet's configuration with the supplied information. | windows_enabled_and_configured | boolean | body | _mdm settings_. Enables Windows MDM support. | | minimum_version | string | body | _mdm.macos_updates settings_. Hosts that belong to no team and are enrolled into Fleet's MDM will be nudged until their macOS is at or above this version. **Requires Fleet Premium license** | | deadline | string | body | _mdm.macos_updates settings_. Hosts that belong to no team and are enrolled into Fleet's MDM won't be able to dismiss the Nudge window once this deadline is past. **Requires Fleet Premium license** | +| deadline_days | integer | body | _mdm.windows_updates settings_. Hosts that belong to no team and are enrolled into Fleet's MDM will have this number of days before updates are installed on Windows. **Requires Fleet Premium license** | +| grace_period_days | integer | body | _mdm.windows_updates settings_. Hosts that belong to no team and are enrolled into Fleet's MDM will have this number of days before Windows restarts to install updates. **Requires Fleet Premium license** | | enable | boolean | body | _mdm.macos_migration settings_. Whether to enable the end user migration workflow for devices migrating from your old MDM solution. **Requires Fleet Premium license** | | mode | string | body | _mdm.macos_migration settings_. The end user migration workflow mode for devices migrating from your old MDM solution. Options are `"voluntary"` or `"forced"`. **Requires Fleet Premium license** | | webhook_url | string | body | _mdm.macos_migration settings_. The webhook url configured to receive requests to unenroll devices migrating from your old MDM solution. **Requires Fleet Premium license** | @@ -1178,6 +1184,10 @@ Note that when making changes to the `integrations` object, all integrations mus "minimum_version": "12.3.1", "deadline": "2022-01-01" }, + "windows_updates": { + "deadline_days": 5, + "grace_period_days": 1 + }, "macos_settings": { "custom_settings": ["path/to/profile1.mobileconfig"], "enable_disk_encryption": true @@ -7385,6 +7395,10 @@ _Available in Fleet Premium_ "minimum_version": "12.3.1", "deadline": "2022-01-01" }, + "windows_updates": { + "deadline_days": 5, + "grace_period_days": 1 + }, "macos_settings": { "custom_settings": ["path/to/profile1.mobileconfig"], "enable_disk_encryption": false @@ -7505,6 +7519,9 @@ _Available in Fleet Premium_ |   macos_updates | object | body | macOS updates settings. | |     minimum_version | string | body | Hosts that belong to this team and are enrolled into Fleet's MDM will be nudged until their macOS is at or above this version. | |     deadline | string | body | Hosts that belong to this team and are enrolled into Fleet's MDM won't be able to dismiss the Nudge window once this deadline is past. | +|   windows_updates | object | body | Windows updates settings. | +|     deadline_days | integer | body | Hosts that belong to this team and are enrolled into Fleet's MDM will have this number of days before updates are installed on Windows. | +|     grace_period_days | integer | body | Hosts that belong to this team and are enrolled into Fleet's MDM will have this number of days before Windows restarts to install updates. | |   macos_settings | object | body | macOS-specific settings. | |     custom_settings | list | body | The list of .mobileconfig files to apply to macOS hosts that belong to this team. | |     enable_disk_encryption | boolean | body | Hosts that belong to this team and are enrolled into Fleet's MDM will have disk encryption enabled if set to true. | @@ -7571,6 +7588,10 @@ _Available in Fleet Premium_ "minimum_version": "12.3.1", "deadline": "2022-01-01" }, + "windows_updates": { + "deadline_days": 5, + "grace_period_days": 1 + }, "macos_settings": { "custom_settings": ["path/to/profile1.mobileconfig"], "enable_disk_encryption": false diff --git a/docs/Using Fleet/Audit-logs.md b/docs/Using Fleet/Audit-logs.md index 5f432e8c16..a27e15997c 100644 --- a/docs/Using Fleet/Audit-logs.md +++ b/docs/Using Fleet/Audit-logs.md @@ -610,6 +610,27 @@ This activity contains the following fields: } ``` +## `edited_windows_updates` + +Generated when the Windows OS updates deadline or grace period is modified. + +This activity contains the following fields: +- "team_id": The ID of the team that the Windows OS updates settings applies to, `null` if it applies to devices that are not in a team. +- "team_name": The name of the team that the Windows OS updates settings applies to, `null` if it applies to devices that are not in a team. +- "deadline_days": The number of days before updates are installed, `null` if the requirement was removed. +- "grace_period_days": The number of days after the deadline before the host is forced to restart, `null` if the requirement was removed. + +#### Example + +```json +{ + "team_id": 3, + "team_name": "Workstations", + "deadline_days": 5, + "grace_period_days": 2 +} +``` + ## read_host_disk_encryption_key Generated when a user reads the disk encryption key for a host.