--- title: "GET /v2/blueprints/" method: GET path: "/v2/blueprints/" tags: ["blueprints_Blueprints API"] --- # GET /v2/blueprints/ `GET /v2/blueprints/` Retrieves a paginated list of all Blueprint V2 blueprints in the enterprise, with optional filtering and sorting. Returns an array of BlueprintV2 objects matching the provided filters; supports filtering by name (case-insensitive or exact), by app or app version IDs across Android, iOS, and Windows, by file or Wi-Fi network references, and by iOS provisioning profile. Results can be ordered by any supported field using the ordering parameter. **About List Blueprints (V2)** Blueprints in Esper define the desired state for managed devices — grouping app assignments, device settings, policies, and content into a reusable configuration template. Blueprint V2 is the current, supported version of the blueprint system; Blueprint V1 is deprecated. This endpoint lists all blueprints scoped to the enterprise, enabling integrators to build UIs, trigger automated deployments, or audit which blueprints reference a given app, file, or network configuration. **Key Fields / Query Parameters** name — Filter by blueprint name, case-insensitive partial match name_exact — Filter by exact name, case-sensitive ordering — Sort results by a field (prefix with - for descending); combine multiple fields with commas (e.g., -created_at,-updated_at) settings__android__app_id — Filter to blueprints that include a specific Android app (by Esper app UUID) settings__android__app_version_id — Filter to blueprints that include a specific Android app version settings__ios__app_id / settings__ios__app_version_id — Same as above for iOS apps settings__windows__app_id / settings__windows__app_version_id — Same as above for Windows apps settings__android__file_id — Filter to blueprints that reference a specific managed file settings__android__wifi_network_id — Filter to blueprints that include a specific Wi-Fi network profile settings__ios__provisioning_profile_id / settings__ios__provisioning_profile_version_id — Filter by iOS provisioning profile or profile version **Common Use Cases** Listing all blueprints to populate a blueprint selection UI or dashboard Finding which blueprints reference a specific app version before pushing an update or deprecating a version Auditing all blueprints that use a particular Wi-Fi network or managed file Retrieving all iOS blueprints that include a specific provisioning profile **Best Practices** Use settings__* filter parameters when tracing blueprint dependencies on a specific resource — this is faster than fetching all blueprints and filtering client-side Use name for fuzzy search and name_exact when integrating with systems that require precise name matching Paginate results using next and previous links in the response for large blueprint libraries **Workflow** Call GET /api/v2/blueprints/ with any relevant filter parameters Inspect the count field in the response to determine if pagination is needed Iterate through next links to retrieve subsequent pages if next is non-null ## Query parameters - `ordering` string - `name` string - `name_exact` string - `settings__android__app_id` string, uuid - `settings__android__app_version_id` string, uuid - `settings__ios__app_id` string, uuid - `settings__ios__app_version_id` string, uuid - `settings__windows__app_id` string, uuid - `settings__windows__app_version_id` string, uuid - `settings__android__file_id` string, uuid - `settings__android__wifi_network_id` string, uuid - `settings__ios__provisioning_profile_id` string, uuid - `settings__ios__provisioning_profile_version_id` string, uuid - `settings__tvos__app_id` string, uuid - `settings__tvos__app_version_id` string, uuid - `settings__tvos__provisioning_profile_id` string, uuid - `settings__tvos__provisioning_profile_version_id` string, uuid ## Response `200` Success - object - `content` object - `count` integer — The number of objects in the result set - `next` string — The link to retrieve the next set of objects in the result set - `previous` string — The link to retrieve the previous set of objects in the result set - `results` BlueprintsBlueprintV2[] - `id` string, uuid - `name` string — Name of the blueprint - `description` string — Description of the blueprint - `comments` string — Comments on the blueprint - `version_number` integer - `version_id` string, uuid - `minor_version_number` integer - `publish` boolean - `settings` BlueprintsSettingsV2 - `android` BlueprintsSettings - `device_mode_settings` BlueprintsDeviceModeSettings - `apply_policy` 'ALWAYS APPLY' | 'IGNORE' | 'PROVISION ONLY' - `device_mode` 'KIOSK' | 'MULTI APP' - `launcher_settings` BlueprintsLauncherSettings - `apply_policy` 'ALWAYS APPLY' | 'IGNORE' | 'PROVISION ONLY', required - `launcher` 'ESPER' | 'DEFAULT', required - `local_app_install_settings` BlueprintsLocalAppInstallSettings - `apply_policy` 'ALWAYS APPLY' | 'IGNORE' | 'PROVISION ONLY', required - `allow_local_app_install` boolean, required - `app_uninstall_settings` BlueprintsAppUninstallSettings - `apply_policy` 'ALWAYS APPLY' | 'IGNORE' | 'PROVISION ONLY', required - `allow_app_uninstallation` boolean, required - `app_permission_policy_settings` BlueprintsAppPermissionPolicySettings - `apply_policy` 'ALWAYS APPLY' | 'IGNORE' | 'PROVISION ONLY', required - `permission_policy` 'ALLOW AUTOMATICALLY' | 'DENY' | 'ASK USER', required - `wifi_settings` BlueprintsWifiSettings - `apply_policy` 'ALWAYS APPLY' | 'IGNORE' | 'PROVISION ONLY', required - `allow_wifi` boolean, required - `wifi_state` 'ENABLE' | 'DISABLE', required - `bluetooth_settings` BlueprintsBluetoothSettings - `apply_policy` 'ALWAYS APPLY' | 'IGNORE' | 'PROVISION ONLY', required - `allow_bluetooth` boolean, required - `bluetooth_state` 'ENABLE' | 'DISABLE' - `drift_policy` 'IGNORE' | 'LOG ONLY' | 'MINOR' | 'MAJOR' | 'CRITICAL' — Allowed values: IGNORE, LOG ONLY, MINOR, MAJOR, CRITICAL - `sms_settings` BlueprintsSmsSettings - `apply_policy` 'ALWAYS APPLY' | 'IGNORE' | 'PROVISION ONLY', required - `allow_sms` boolean, required - `nfc_settings` BlueprintsNfcSettings - `apply_policy` 'ALWAYS APPLY' | 'IGNORE' | 'PROVISION ONLY', required - `allow_nfc` boolean, required - `incoming_numbers_settings` BlueprintsIncomingNumbersSettings - `apply_policy` 'ALWAYS APPLY' | 'IGNORE' | 'PROVISION ONLY', required - `allow_all_numbers` boolean, required - `allowed_numbers` string[] - `tags` string[] - `outgoing_numbers_settings` BlueprintsOutgoingNumbersSettings - `apply_policy` 'ALWAYS APPLY' | 'IGNORE' | 'PROVISION ONLY', required - `allow_all_numbers` boolean, required - `allow_ussd_codes` boolean - `allowed_numbers` string[] - `tags` string[] - `ethernet_settings` BlueprintsEthernetSettings - `apply_policy` 'ALWAYS APPLY' | 'IGNORE' | 'PROVISION ONLY', required - `auth_mode` 'NONE' | 'EAP-TLS' - `ca_cert_alias` string - `client_cert_alias` string - `eap_identity` string - `adb_settings` BlueprintsAdbSettings - `apply_policy` 'ALWAYS APPLY' | 'IGNORE' | 'PROVISION ONLY', required - `allow_adb` boolean, required - `safe_boot_settings` BlueprintsSafeBootSettings - `apply_policy` 'ALWAYS APPLY' | 'IGNORE' | 'PROVISION ONLY', required - `allow_safe_boot` boolean, required - `factory_reset_settings` BlueprintsFactoryResetSettings - `apply_policy` 'ALWAYS APPLY' | 'IGNORE' | 'PROVISION ONLY', required - `allow_factory_reset` boolean, required - `screen_timeout_settings` BlueprintsScreenTimeoutSettings - `apply_policy` 'ALWAYS APPLY' | 'IGNORE' | 'PROVISION ONLY', required - `screentimeout_value` integer, required - `lock_screen_settings` BlueprintsLockScreenSettings - `apply_policy` 'ALWAYS APPLY' | 'IGNORE' | 'PROVISION ONLY', required - `password_quality` 'NONE' | 'ALPHABETIC' | 'NUMERIC' | 'ALPHANUMERIC' | 'COMPLEX' | 'BIOMETRIC_WEAK', required - `minimum_password_length` integer, nullable - `allow_keyguard` boolean, required - `brightness_settings` BlueprintsBrightnessSettings - `apply_policy` 'ALWAYS APPLY' | 'IGNORE' | 'PROVISION ONLY' - `brightness_value` string - `screen_orientation_settings` BlueprintsScreenOrientationSettings - `apply_policy` 'ALWAYS APPLY' | 'IGNORE' | 'PROVISION ONLY' - `orientation_type` 'PORTRAIT' | 'LANDSCAPE' | 'INVERTED PORTRAIT' | 'INVERTED LANDSCAPE' | 'AUTO' - `screenshot_settings` BlueprintsScreenshotSettings - `apply_policy` 'ALWAYS APPLY' | 'IGNORE' | 'PROVISION ONLY' - `allow_screenshot` boolean - `notification_bar_settings` BlueprintsNotificationBarSettings - `apply_policy` 'ALWAYS APPLY' | 'IGNORE' | 'PROVISION ONLY' - `allow_notification_bar` boolean - `wallpaper_settings` BlueprintsWallpaperSettings - `homescreen` object - … - `lockscreen` object - … - `esper_settings_apps_settings` BlueprintsEsperSettingsAppsSettings - `apply_policy` 'ALWAYS APPLY' | 'IGNORE' | 'PROVISION ONLY' - `allow_dock` boolean - `admin_mode_password` string - `allow_esper_settings_app` boolean - `settings` object, required - … - `android_settings_app_settings` BlueprintsAndroidSettingsAppSettings - `apply_policy` 'ALWAYS APPLY' | 'IGNORE' | 'PROVISION ONLY' - `allow_android_settings_app` boolean, required - `customized_device_level_json_settings` BlueprintsCustomizedDeviceLevelJsonSettings - `apply_policy` 'ALWAYS APPLY' | 'IGNORE' | 'PROVISION ONLY' - `customized_json` object, required - `google_services_settings` BlueprintsGoogleServicesSettings - `afw_account_settings` object, required - … - `personal_accounts_settings` object, required - … - `play_store_settings` object, required - … - `google_assitant_settings` object, required - … - `factory_reset_protection_settings` object, required - … - `external_device_settings` BlueprintsExternalDeviceSettings - `apply_policy` 'ALWAYS APPLY' | 'IGNORE' | 'PROVISION ONLY' - `allow_external_device_mount` boolean - `usb_tethering_settings` BlueprintsUsbTetheringSettings - `apply_policy` 'ALWAYS APPLY' | 'IGNORE' | 'PROVISION ONLY' - `allow_usb_tethering` boolean - `file_transfer_settings` BlueprintsFileTransferSettings - `apply_policy` 'ALWAYS APPLY' | 'IGNORE' | 'PROVISION ONLY' - `allow_file_transfer` boolean - `camera_settings` BlueprintsCameraSettings - `apply_policy` 'ALWAYS APPLY' | 'IGNORE' | 'PROVISION ONLY' - `allow_camera_access` boolean - `location_settings` BlueprintsLocationSettings - `apply_policy` 'ALWAYS APPLY' | 'IGNORE' | 'PROVISION ONLY' - `allow_location` boolean - `sound_settings` BlueprintsSoundSettings - `alarm_settings` object - … - `music_settings` object - … - `ringtone_settings` object - … - `notification_settings` object - … - `voice_call_settings` object - … - `system_updates_settings` BlueprintsSystemUpdatesSettings - `apply_policy` 'ALWAYS APPLY' | 'IGNORE' | 'PROVISION ONLY' - `system_update_policy_type` 'UPDATE AUTOMATICALLY' | 'POSTPONE INSTALLATION' | 'WINDOWED INSTALLATION' | 'DISABLE UPDATE' | 'DEFAULT UPDATE' - `maintenance_start` string - `maintenance_end` string - `time_date_settings` BlueprintsTimeDateSettings - `apply_policy` 'ALWAYS APPLY' | 'IGNORE' | 'PROVISION ONLY' - `allow_edit_time_date` boolean - `timezone_settings` BlueprintsTimezoneSettings - `apply_policy` 'ALWAYS APPLY' | 'IGNORE' | 'PROVISION ONLY' - `timezone` string - `language_settings` BlueprintsLanguageSettings - `apply_policy` 'ALWAYS APPLY' | 'IGNORE' | 'PROVISION ONLY' - `device_locale` string - `strict_wifi_synchronization_settings` BlueprintsStrictWifiSynchronizationSettings - `apply_policy` 'ALWAYS APPLY' | 'IGNORE' | 'PROVISION ONLY' - `allow_strict_wifi_synchronization` boolean - `strict_app_synchronization_settings` BlueprintsStrictAppSynchronizationSettings - `apply_policy` 'ALWAYS APPLY' | 'IGNORE' | 'PROVISION ONLY' - `allow_strict_app_synchronization` boolean - `apps` BlueprintsApp[] - `app_id` string, required - `app_version_id` string, required - `package_name` string, required - `installation_rule` 'POST PROVISIONING' | 'DURING PROVISIONING', required - `state` 'SHOW' | 'HIDE' | 'DISABLE' | 'LAUNCHABLE_BUT_HIDDEN', required - `managed_config` object - `type` 'PRELOADED' | 'ENTERPRISE' | 'PLAYSTORE', required - `auto_update_mode` 'autoUpdateDefault' | 'autoUpdateHighPriority' | 'autoUpdatePostponed', required - `files` BlueprintsFile[] - `file_id` integer, required — File identifier from Content Management - `destination_path` string, required - `wifi_networks` BlueprintsWifiNetwork[] - `wifi_network_id` string, required - `certificate_file_path` string - `certificate_file_password` string - `saved_ap_settings` BlueprintsSavedApSettings - `apply_policy` 'ALWAYS APPLY' | 'IGNORE' | 'PROVISION ONLY', required - `use_only_saved_ap` boolean, required - `mac_address_randomization_settings` BlueprintsMacAddressRandomizationSettings - `apply_policy` 'ALWAYS APPLY' | 'IGNORE' | 'PROVISION ONLY' - `allow_mac_address_randomization` boolean - `esper_edgebox_settings` BlueprintsEsperEdgeboxSettings - `apply_policy` 'ALWAYS APPLY' | 'IGNORE' | 'PROVISION ONLY' - `allow_esper_edgebox` boolean - `app_layout_setting` BlueprintsAppLayoutSetting - `apply_policy` 'ALWAYS APPLY' | 'IGNORE' | 'PROVISION ONLY' - `brand_logo_position` 'BOTTOM_LEFT' | 'BOTTOM_RIGHT' | 'TOP_LEFT' | 'TOP_RIGHT' - `device_name_position` 'BOTTOM_LEFT' | 'BOTTOM_RIGHT' | 'TOP_LEFT' | 'TOP_RIGHT' - `app_icon_size` 'SMALL_ICON' | 'MEDIUM_ICON' | 'LARGE_ICON' | 'DEFAULT_ICON' | 'CUSTOM_ICON' - `app_name_size` 'SMALL_TEXT' | 'MEDIUM_TEXT' | 'LARGE_TEXT' | 'DEFAULT_TEXT' | 'CUSTOM_TEXT' - `device_name_and_id_display_policy` 'NONE' | 'DEFAULT' | 'DEVICE_ID_ONLY' | 'ALIAS_NAME_ONLY' | 'DEVICE_ID_AND_ALIAS_NAME' - `device_name_size` 'SMALL_TEXT' | 'MEDIUM_TEXT' | 'LARGE_TEXT' | 'DEFAULT_TEXT' | 'CUSTOM_TEXT' - `device_alias_size` 'SMALL_TEXT' | 'MEDIUM_TEXT' | 'LARGE_TEXT' | 'DEFAULT_TEXT' | 'CUSTOM_TEXT' - `custom_app_icon_size` integer - `custom_device_name_size` integer - `custom_device_alias_size` integer - `custom_app_name_size` integer - `app_order_setting` BlueprintsAppOrderSetting - `apply_policy` 'ALWAYS APPLY' | 'IGNORE' | 'PROVISION ONLY' - `app_order_list` BlueprintsAppIcon[] - … - `advanced_configurations` BlueprintsAdvancedConfigurations — OEM-specific advanced configurations for AIDC devices. Currently supports Zebra (DataWedge, MX Config, OEM Config). - `oem_manufacturer` 'ZEBRA', nullable - `oem_settings` BlueprintsOemSettings — Container for all OEM subsystem settings (DataWedge, MX Config, OEM Config). - … - `ios` BlueprintsIosSettings - `kiosk_app` BlueprintsKioskModeSettings - `app_id` string - `app_type` 'VPP' | 'TENANT_IOS' | 'ESPER_IOS' | 'WEBCLIP' | 'PRELOADED' - `disable_device_rotation` boolean - `disable_screen_timeout` boolean - `device_mode_settings` BlueprintsDeviceModeSettings - `apply_policy` 'ALWAYS APPLY' | 'IGNORE' | 'PROVISION ONLY' - `device_mode` 'KIOSK' | 'MULTI APP' - `local_app_install_settings` BlueprintsLocalAppInstallSettingsIos - `apply_policy` 'ALWAYS APPLY' | 'IGNORE' | 'PROVISION ONLY', required - `allow_local_app_install` boolean, required - `app_uninstall_settings` BlueprintsAppUninstallSettingsIos - `apply_policy` 'ALWAYS APPLY' | 'IGNORE' | 'PROVISION ONLY', required - `allow_app_uninstallation` boolean, required - `bluetooth_settings` BlueprintsBluetoothSettingsIos - `apply_policy` 'ALWAYS APPLY' | 'IGNORE' | 'PROVISION ONLY', required - `edit_bluetooth` boolean, required - `nfc_settings` BlueprintsNfcSettingsIos - `apply_policy` 'ALWAYS APPLY' | 'IGNORE' | 'PROVISION ONLY', required - `allow_nfc` boolean, required - `factory_reset_settings` BlueprintsFactoryResetSettingsIos - `apply_policy` 'ALWAYS APPLY' | 'IGNORE' | 'PROVISION ONLY', required - `allow_factory_reset` boolean, required - `screenshot_settings` BlueprintsScreenshotSettingsIos - `apply_policy` 'ALWAYS APPLY' | 'IGNORE' | 'PROVISION ONLY' - `allow_screenshot` boolean - `custom_device_level_profile_settings` BlueprintsCustomDeviceLevelProfileSettingsIos - `apply_policy` 'ALWAYS APPLY' | 'IGNORE' | 'PROVISION ONLY' - `custom_profile` string, nullable - `siri_settings` BlueprintsSiriSettingsIos - `apply_policy` 'ALWAYS APPLY' | 'IGNORE' | 'PROVISION ONLY', required - `allow_siri` boolean, required - `tethering_settings` BlueprintsTetheringSettingsIos - `apply_policy` 'ALWAYS APPLY' | 'IGNORE' | 'PROVISION ONLY' - `edit_hotspot` boolean - `camera_settings` BlueprintsCameraSettingsIos - `apply_policy` 'ALWAYS APPLY' | 'IGNORE' | 'PROVISION ONLY' - `allow_camera_access` boolean - `hide_preloaded_apps_settings` BlueprintsHidePreloadedAppsSettingsIos - `apply_policy` 'ALWAYS APPLY' | 'IGNORE' | 'PROVISION ONLY' - `hide_preloaded_apps` boolean - `time_date_settings` BlueprintsTimeDateSettingsIos - `apply_policy` 'ALWAYS APPLY' | 'IGNORE' | 'PROVISION ONLY' - `force_automatic_time_date` boolean - `wifi_networks` BlueprintsWifiNetworkIos[] - `wifi_network_id` string, required - `apps` BlueprintsIosApp[] - `app_id` string, required - `app_version_id` string, required - `state` 'SHOW', required - `app_type` 'VPP' | 'TENANT_IOS' | 'ESPER_IOS' | 'WEBCLIP' | 'PRELOADED', required - `base64_app_config` string - `auto_update` boolean — Enable automatic updates for the app. Only allowed when app_type is VPP. - `provisioning_profiles` BlueprintsProvisioningProfileIos[] - `profile_id` string, uuid, required - `profile_version_id` string, uuid, required - `wallpaper_settings` BlueprintsIosWallpaperSettings - `homescreen` object - … - `lockscreen` object - … - `web_content_settings` BlueprintsWebContentSettingIos - `apply_policy` 'ALWAYS APPLY' | 'IGNORE' | 'PROVISION ONLY' - `url_blocklist` string[] - `url_allowlist` string[] - `defer_os_updates` BlueprintsDeferOsUpdates - `apply_policy` 'ALWAYS APPLY' | 'IGNORE' | 'PROVISION ONLY' - `defer_os_updates_delay` integer - `strict_wifi_synchronization_settings` BlueprintsStrictWifiSynchronizationSettings - `apply_policy` 'ALWAYS APPLY' | 'IGNORE' | 'PROVISION ONLY' - `allow_strict_wifi_synchronization` boolean - `tvos` BlueprintsTvosSettings — Configuration settings specific to tvOS (Apple TV) devices - `device_mode_settings` BlueprintsDeviceModeSettings - `apply_policy` 'ALWAYS APPLY' | 'IGNORE' | 'PROVISION ONLY' - `device_mode` 'KIOSK' | 'MULTI APP' - `kiosk_app` BlueprintsTvosKioskModeSettings — Kiosk app configuration for tvOS. WEBCLIP and PRELOADED types are not allowed. - `app_id` string, uuid, required - `app_type` 'VPP' | 'TENANT_IOS' | 'ESPER_IOS', required - `custom_device_level_profile_settings` BlueprintsCustomDeviceLevelProfileSettingsIos - `apply_policy` 'ALWAYS APPLY' | 'IGNORE' | 'PROVISION ONLY' - `custom_profile` string, nullable - `hide_preloaded_apps_settings` BlueprintsHidePreloadedAppsSettingsIos - `apply_policy` 'ALWAYS APPLY' | 'IGNORE' | 'PROVISION ONLY' - `hide_preloaded_apps` boolean - `time_date_settings` BlueprintsTimeDateSettingsIos - `apply_policy` 'ALWAYS APPLY' | 'IGNORE' | 'PROVISION ONLY' - `force_automatic_time_date` boolean - `wifi_access_points` BlueprintsWifiAccessPointsTvos - `apply_policy` 'ALWAYS APPLY' | 'IGNORE' | 'PROVISION ONLY' - `wifi_networks` BlueprintsWifiNetworkIos[] - `wifi_network_id` string, required - `apps` BlueprintsTvosApp[] - `app_id` string, uuid, required - `app_version_id` string, uuid, required - `state` 'SHOW', required - `app_type` 'VPP' | 'TENANT_IOS' | 'ESPER_IOS' | 'PRELOADED', required - `base64_app_config` string - `auto_update` boolean — Enable automatic updates for the app. Only allowed when app_type is VPP. - `provisioning_profiles` BlueprintsProvisioningProfileIos[] - `profile_id` string, uuid, required - `profile_version_id` string, uuid, required - `defer_os_updates` BlueprintsDeferOsUpdates - `apply_policy` 'ALWAYS APPLY' | 'IGNORE' | 'PROVISION ONLY' - `defer_os_updates_delay` integer - `strict_wifi_synchronization_settings` BlueprintsStrictWifiSynchronizationSettings - `apply_policy` 'ALWAYS APPLY' | 'IGNORE' | 'PROVISION ONLY' - `allow_strict_wifi_synchronization` boolean - `linux` BlueprintsLinuxSettings — Configuration settings specific to Linux devices in a blueprint - `custom_shell_scripts_multiple` BlueprintsCustomShellScriptsMultiple - `shell_scripts` BlueprintsShellScriptLinux[] - … - `custom_actions_multiple` BlueprintsCustomActionsMultipleLinux — Collection of custom actions to be applied on Linux devices. - `custom_actions` BlueprintsCustomActionLinux[] — List of custom actions to apply to Linux devices. - … - `files` BlueprintsLinuxFile[] - `file_id` integer, required - `destination_path` string, required - `windows` BlueprintsWindowsSettings - `active_hours_settings` BlueprintsActiveHoursSettingsWindows — Windows active hours configuration for controlling update installation timing - `active_hours_start` object, required — Start time for active hours - … - `active_hours_end` object, required — End time for active hours - … - `apps` BlueprintsWindowsApp[] - `app_id` string, required - `app_version_id` string, required - `state` 'SHOW', required - `app_type` 'TENANT_WINDOWS' | 'ESPER_WINDOWS' | 'TENANT_WINDOWS_EXE' | 'TENANT_WINDOWS_UWP', required - `base64_app_config` string - `auto_update_settings` BlueprintsAutoUpdateSettingsWindows — Windows automatic updates configuration - `apply_policy` 'ALWAYS APPLY' | 'IGNORE' | 'PROVISION ONLY', required - `auto_update_type` 'NOTIFY_DOWNLOAD' | 'AUTO_INSTALL_AND_NOTIFY_RESTART' | 'DEFAULT' | 'SCHEDULED_INSTALL_AND_RESTART' | 'AUTO_INSTALL_AND_RESTART_FORCED' | 'OFF', required — Type of automatic update behavior, mapped to the Windows CSP Update/AllowAutoUpdate. NOTIFY_DOWNLOAD notifies before downloading; AUTO_INSTALL_AND_NOTIFY_RESTART auto-installs and notifies to schedule a restart; DEFAULT auto-installs and restarts (system default); SCHEDULED_INSTALL_AND_RESTART auto-installs and restarts at a scheduled time; AUTO_INSTALL_AND_RESTART_FORCED auto-installs and restarts without end-user control; OFF disables automatic updates. - `background_scripts` BlueprintsBackgroundScriptSettings[] - `id` string, uuid, required — Identifier of the background script registered in the tenant. - `apply_policy` 'ALWAYS APPLY' | 'IGNORE' | 'PROVISION ONLY' - `bluetooth_settings` BlueprintsBluetoothSettings - `apply_policy` 'ALWAYS APPLY' | 'IGNORE' | 'PROVISION ONLY', required - `allow_bluetooth` boolean, required - `bluetooth_state` 'ENABLE' | 'DISABLE' - `drift_policy` 'IGNORE' | 'LOG ONLY' | 'MINOR' | 'MAJOR' | 'CRITICAL' — Allowed values: IGNORE, LOG ONLY, MINOR, MAJOR, CRITICAL - `camera_settings` BlueprintsCameraSettings - `apply_policy` 'ALWAYS APPLY' | 'IGNORE' | 'PROVISION ONLY' - `allow_camera_access` boolean - `custom_policies` BlueprintsCustomPolicySetting[] - `apply_policy` 'ALWAYS APPLY' | 'IGNORE' | 'PROVISION ONLY', required - `is_atomic` boolean, required - `b64_csp_payload` string, required — Base64-encoded CSP (SyncML/OMA-DM) payload. - `alias` string, required - `description` string - `custom_shell_scripts_multiple` BlueprintsCustomShellScriptsMultipleWindows - `shell_scripts` BlueprintsPowerShellScriptWindows[] - … - `device_mode_settings` BlueprintsDeviceModeSettings - `apply_policy` 'ALWAYS APPLY' | 'IGNORE' | 'PROVISION ONLY' - `device_mode` 'KIOSK' | 'MULTI APP' - `defer_os_updates` BlueprintsDeferOsUpdatesWindows — Windows OS updates deferral configuration with separate quality and feature update controls - `quality_updates` object, required — Quality updates deferral settings - … - `feature_updates` object, required — Feature updates deferral settings - … - `factory_reset_settings` BlueprintsFactoryResetSettings - `apply_policy` 'ALWAYS APPLY' | 'IGNORE' | 'PROVISION ONLY', required - `allow_factory_reset` boolean, required - `kiosk_settings` BlueprintsWindowsKioskSettings — Windows kiosk configuration. kiosk_type determines the kiosk mechanism: CONFIGURATION uses Windows Assigned Access, SHELL_LAUNCHER uses Shell Launcher. Exactly one of win32_single_app_config or uwp_single_app_config must be set when kiosk_settings is present. kiosk_type defaults to CONFIGURATION if omitted (backward compatible with pre-existing blueprints). - `kiosk_type` 'CONFIGURATION' | 'SHELL_LAUNCHER' — Kiosk mechanism to use. CONFIGURATION uses Windows Assigned Access; SHELL_LAUNCHER uses Shell Launcher. Defaults to CONFIGURATION if omitted. - `win32_single_app_config` BlueprintsWindowsKioskWin32SingleAppConfig — Win32 single-app kiosk configuration. Defaults applied if not provided. - … - `uwp_single_app_config` BlueprintsWindowsKioskUwpSingleAppConfig — UWP single-app kiosk configuration. app_id must match an entry in windows.apps with app_type TENANT_WINDOWS_UWP. - … - `pause_os_updates` BlueprintsPauseOsUpdatesWindows — Windows pause OS updates configuration - `apply_policy` 'ALWAYS APPLY' | 'IGNORE' | 'PROVISION ONLY', required - `pause_os_updates` boolean, required — Whether to pause OS updates - `scheduled_install_settings` BlueprintsScheduledInstallSettingsWindows — Windows scheduled install configuration. Only valid when auto_update_type is SCHEDULED_INSTALL_AND_RESTART or AUTO_INSTALL_AND_RESTART_FORCED. Each sub-field is optional — omitting it leaves the corresponding Windows default in effect (3 AM, every day, every week). - `scheduled_install_day` object — Day of the week for scheduled install. Maps to Update/ScheduledInstallDay CSP. - … - `scheduled_install_week` object — Week of the month for scheduled install. Maps to Update/ScheduledInstall*Week CSPs. - … - `scheduled_install_time` object — Hour of day for scheduled install (0 = 12 AM, 23 = 11 PM). Maps to Update/ScheduledInstallTime CSP. - … - `timezone_settings` BlueprintsTimezoneSettings - `apply_policy` 'ALWAYS APPLY' | 'IGNORE' | 'PROVISION ONLY' - `timezone` string - `unenrollment_settings` BlueprintsUnenrollmentSettingsWindows - `apply_policy` 'ALWAYS APPLY' | 'IGNORE' | 'PROVISION ONLY', required - `allow_unenrollment_from_device` boolean, required - `wallpaper_settings` BlueprintsWindowsWallpaperSettings — Configuration for Windows desktop wallpaper settings including homescreen and lockscreen backgrounds. Uses landscape orientation only. - `homescreen` object — Wallpaper settings for the Windows desktop homescreen - … - `lockscreen` object — Wallpaper settings for the Windows lock screen - … - `wifi_networks` BlueprintsWifiNetworkWindows[] - `wifi_network_id` string, required - `created_by` string — ID of the user who created the blueprint - `updated_by` string — ID of the user who updated the blueprint - `created_at` string, date-time - `updated_at` string, date-time - `message` string - `code` integer --- [API](https://skmtc.net/esper/apis/esper-api-reference.md) · [All operations](https://skmtc.net/esper/apis/esper-api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/esper/esper-api-reference/revisions/e1f64cbb488e/schema)