Windows Update Policies
Manage update policies with approval workflows
Create a new update policy
Creates a new Windows Update policy with approval rules, auto-approval settings, and deployment ring assignment.
List all update policies
Returns all Windows Update policies for the tenant with approval counts.
Get Windows feature versions for upgrades
Returns available Windows feature upgrade version targets.
Get a specific update policy
Returns a single Windows Update policy by ID.
Update an existing policy
Updates fields on a Windows Update policy.
Delete an update policy
Deletes a Windows Update policy. Default policies cannot be deleted.
Get approvals for a policy
Returns paginated list of approved updates for a policy.
Activate emergency override
Activates an emergency override on a policy, temporarily bypassing normal approval workflow.
Deactivate emergency override
Deactivates the emergency override on a policy.
Get effective approval status for auto-approval mode
Returns the effective approval status for a policy operating in auto-approval mode.
Duplicate a policy
Creates a copy of an existing policy with a new name.
Get tags assigned to a policy
Returns agent tags associated with a policy.
Add tag to a policy
Associates an agent tag with a policy.
Remove tag from a policy
Removes an agent tag association from a policy.
Approve a single update for a policy
Adds a single update approval to a policy. Visibility-only updates (SSU, Dynamic) cannot be approved.
Bulk approve updates for a policy
Approves multiple updates for a policy in a single request. Maximum 1000 per request. Visibility-only updates are rejected.
Bulk remove approvals from a policy
Removes multiple update approvals from a policy in a single request. Maximum 1000 per request.
Remove a single approval from a policy
Removes a specific approval. Optionally creates an override to prevent re-approval for auto-approved updates.
List approval overrides for a policy
Returns paginated list of auto-approval overrides (exclusions) for a policy.
Create an approval override
Creates an override to prevent a specific update from being auto-approved by the policy.
Reset all overrides for a policy
Deletes all approval overrides for a policy. Requires confirmation body.
Remove override by update ID
Convenience endpoint to remove an override using the update ID rather than the override ID.
Remove a specific override
Removes a single approval override by its ID.