---
title: "PUT /{stack}/adminconfig/v2/maintenance-windows/preferences"
method: PUT
path: "/{stack}/adminconfig/v2/maintenance-windows/preferences"
tags: ["MaintenanceWindows"]
---

# PUT /{stack}/adminconfig/v2/maintenance-windows/preferences

`PUT /{stack}/adminconfig/v2/maintenance-windows/preferences`

Update maintenance window preferences for a stack.

## Path parameters

- `stack` string, required

## Request body

- MaintenanceWindowsPreferencesRequest
  - `changeFreezes` MaintenanceWindowsChangeFreezeRequest, required
    - `customerInitiatedFreezes` MaintenanceWindowsCustomerInitiatedFreezeRequest[], required
      - `appliesTo` string, required — Type of changes the change freeze applies to.
      - `endDate` string, required — Date (YYYY/MM/DD) when the change freeze ends.
      - `id` string — Unique identifier (UUID) of the change freeze. This field should be left empty for new change freezes.
      - `reason` string, required — Reason for the change freeze.
      - `startDate` string, required — Date (YYYY/MM/DD) when the change freeze starts.
  - `preferredSchedule` MaintenanceWindowsPreferredSchedule — Preferred schedule configuration for maintenance windows.
    - `additionalPreferences` MaintenanceWindowsAdditionalPreference[] — Additional time windows for scheduling smaller impact changes. If no Alternate Preferences (under Preferred Window) are provided, then at least one Additional Preferences must be provided. Maximum of three Additional Preferences can be provided.
      - `daysOfWeek` DayOfWeek[], required — Days of the week for this additional preference.
      - `timeSlot` MaintenanceWindowsTimeSlot, required — Represents a time range. If end time is before start time, it indicates the time range spans midnight.
        - `end` string, required — End time in HH:MM UTC format.
        - `start` string, required — Start time in HH:MM UTC format.
    - `preferredWindow` MaintenanceWindowsPreferredWindow — Preferred time and day of week for scheduling maintenance windows.
      - `alternateDays` DayOfWeek[], required — Alternate days of the week chosen by customers, which can be used if the primary preferred day is not available.
      - `preferredDay` 'Monday' | 'Tuesday' | 'Wednesday' | 'Thursday' | 'Friday' | 'Saturday' | 'Sunday', required — Day of the week.
      - `timeSlot` MaintenanceWindowsTimeSlot, required — Represents a time range. If end time is before start time, it indicates the time range spans midnight.
        - `end` string, required — End time in HH:MM UTC format.
        - `start` string, required — Start time in HH:MM UTC format.
  - `recordVersion` integer — Version of the record.

## Response `204`

successfully updated the maintenance window preferences for the stack

## Other responses

- `default` — unexpected error

---

[API](https://skmtc.dev/splunk/apis/splunk-cloud-admin-api.md) · [All operations](https://skmtc.dev/splunk/apis/splunk-cloud-admin-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/splunk/splunk-cloud-admin-api/revisions/65903649d1c2/schema)