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

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

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

Describe maintenance window preferences for a stack.

## Path parameters

- `stack` string, required

## Response `200`

successfully described the maintenance window preferences for the stack

- MaintenanceWindowsPreferencesResponse
  - `changeFreezes` MaintenanceWindowsChangeFreezeResponse, required
    - `customerInitiatedFreezes` MaintenanceWindowsCustomerInitiatedFreezeResponse[], required
      - `appliesTo` string, required — Type of changes the change freeze applies to.
      - `createdTimestamp` string, date-time, required — Time at which the change freeze was created.
      - `endDate` string, required — Date (YYYY/MM/DD) when the change freeze ends.
      - `id` string, required — UUID of the change freeze.
      - `lastModifiedTimestamp` string, date-time, required — Time at which the change freeze was last modified.
      - `reason` string, required — Reason for the change freeze.
      - `startDate` string, required — Date (YYYY/MM/DD) when the change freeze starts.
      - `tickets` string[], required — [DEPRECATED] List of SFDC cases associated with the change freeze request. Use `ticketsV2` instead.
      - `ticketsV2` MaintenanceWindowsTicket[], required — List of SFDC cases associated with the change freeze request.
        - `id` string, required — ID of the ticket.
        - `type` string, required — Type of ticket. Salesforce (SFDC) tickets are the only ticket types exposed via ACS.
        - `url` string, required — URL to the ticket.
    - `splunkInitiatedFreezes` MaintenanceWindowsSplunkInitiatedFreezeResponse[], required
      - `appliesTo` string, required — Type of changes the change freeze applies to.
      - `category` string, required — Category of change freeze.
      - `createdTimestamp` string, date-time, required — Time at which the change freeze was created.
      - `endDate` string, required — Date (YYYY/MM/DD) when the change freeze ends.
      - `id` string, required — UUID of the change freeze.
      - `lastModifiedTimestamp` string, date-time, required — Time at which the change freeze was last modified.
      - `reason` string, required — Reason for the change freeze.
      - `startDate` string, required — Date (YYYY/MM/DD) when the change freeze starts.
      - `tickets` string[], required — [DEPRECATED] List of SFDC cases associated with the change freeze request. Use `ticketsV2` instead.
      - `ticketsV2` MaintenanceWindowsTicket[], required — List of SFDC cases associated with the change freeze request.
        - `id` string, required — ID of the ticket.
        - `type` string, required — Type of ticket. Salesforce (SFDC) tickets are the only ticket types exposed via ACS.
        - `url` string, required — URL to the ticket.
  - `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, required — Version of the record.
  - `warning` string — Warning message indicating feature eligibility status. Present only when stack is not enabled for preferred maintenance windows feature.

## 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)