--- title: "GET /v2/blueprints/{blueprint_id}/versions/{version_id}/" method: GET path: "/v2/blueprints/{blueprint_id}/versions/{version_id}/" tags: ["blueprints_Blueprints API"] --- # GET /v2/blueprints/{blueprint_id}/versions/{version_id}/ `GET /v2/blueprints/{blueprint_id}/versions/{version_id}/` Retrieves the full configuration for a single, specific version of a blueprint. Returns the complete settings payload for the given version_id, including whatever apps, files, Wi-Fi networks, and platform-specific restrictions were defined at that point in the blueprint's history. **About Get Blueprint Version** This is the endpoint that returns the actual configuration a device receives when converged to a blueprint, since Converge applies a specific blueprint_version_id rather than just a blueprint_id. Use it to inspect exactly what a version will change on a device before rolling it out broadly. **Common Use Cases** Reviewing a version's full settings before using it in a Converge action Comparing two versions of the same blueprint to understand what changed between them **Best Practices** Always confirm the version_id belongs to the expected blueprint_id, since version IDs are not unique across blueprints in isolation Review a version's settings in full before converging a large device group to it, since Converge applies the configuration broadly and does not offer a partial rollback **Workflow** Call GET /v2/blueprints/{blueprint_id}/versions/ to find the version_id you need Call this endpoint with both blueprint_id and version_id to retrieve the full settings Use the blueprint_id and blueprint_version_id together in a POST to /v2/converge to apply this version to a device ## Path parameters - `blueprint_id` string, uuid, required - `version_id` string, uuid, required ## Response `200` Success - object - `content` 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 - `apply_policy` 'ALWAYS APPLY' | 'IGNORE' | 'PROVISION ONLY' - `portrait` object - … - `landscape` object - … - `lockscreen` object - `apply_policy` 'ALWAYS APPLY' | 'IGNORE' | 'PROVISION ONLY' - `portrait` 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 - `flashlight` 'NONE' | 'USER' | 'ADMIN' | 'BOTH' - `wifi` 'NONE' | 'USER' | 'ADMIN' | 'BOTH' - `auto_rotation` 'NONE' | 'USER' | 'ADMIN' | 'BOTH' - `reboot` 'NONE' | 'USER' | 'ADMIN' | 'BOTH' - `clear_app_data` 'NONE' | 'USER' | 'ADMIN' | 'BOTH' - `kiosk_app_selection` 'NONE' | 'USER' | 'ADMIN' | 'BOTH' - `esper_branding` 'NONE' | 'USER' | 'ADMIN' | 'BOTH' - `factory_reset` 'NONE' | 'USER' | 'ADMIN' | 'BOTH' - `about` 'NONE' | 'USER' | 'ADMIN' | 'BOTH' - `display` 'NONE' | 'USER' | 'ADMIN' | 'BOTH' - `sound` 'NONE' | 'USER' | 'ADMIN' | 'BOTH' - `keyboard` 'NONE' | 'USER' | 'ADMIN' | 'BOTH' - `input_selection` 'NONE' | 'USER' | 'ADMIN' | 'BOTH' - `accessibility` 'NONE' | 'USER' | 'ADMIN' | 'BOTH' - `accessibility_reset_to_default` 'NONE' | 'USER' | 'ADMIN' | 'BOTH' - `accessibility_high_contrast_text` 'NONE' | 'USER' | 'ADMIN' | 'BOTH' - `accessibility_cc_deuteranomaly` 'NONE' | 'USER' | 'ADMIN' | 'BOTH' - `accessibility_cc_protanomaly` 'NONE' | 'USER' | 'ADMIN' | 'BOTH' - `accessibility_cc_tritanomaly` 'NONE' | 'USER' | 'ADMIN' | 'BOTH' - `accessibility_mono_audio` 'NONE' | 'USER' | 'ADMIN' | 'BOTH' - `accessibility_display_size` 'NONE' | 'USER' | 'ADMIN' | 'BOTH' - `accessibility_font_scale` 'NONE' | 'USER' | 'ADMIN' | 'BOTH' - `accessibility_talkback` 'NONE' | 'USER' | 'ADMIN' | 'BOTH' - `accessibility_text_to_speech` 'NONE' | 'USER' | 'ADMIN' | 'BOTH' - `mobile_data` 'NONE' | 'USER' | 'ADMIN' | 'BOTH' - `bluetooth` 'NONE' | 'USER' | 'ADMIN' | 'BOTH' - `language` 'NONE' | 'USER' | 'ADMIN' | 'BOTH' - `time_and_date` 'NONE' | 'USER' | 'ADMIN' | 'BOTH' - `storage` 'NONE' | 'USER' | 'ADMIN' | 'BOTH' - `data_roaming` 'NONE' | 'USER' | 'ADMIN' | 'BOTH' - `wifi_tethering` 'NONE' | 'USER' | 'ADMIN' | 'BOTH' - `airplane_mode` 'NONE' | 'USER' | 'ADMIN' | 'BOTH' - `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 - `apply_policy` 'ALWAYS APPLY' | 'IGNORE' | 'PROVISION ONLY', required - `allow_afw_account_addition` boolean, required - `personal_accounts_settings` object, required - `apply_policy` 'ALWAYS APPLY' | 'IGNORE' | 'PROVISION ONLY', required - `personal_accounts_limit_value` integer, required - `play_store_settings` object, required - `apply_policy` 'ALWAYS APPLY' | 'IGNORE' | 'PROVISION ONLY', required - `allow_playstore` boolean, required - `google_assitant_settings` object, required - `apply_policy` 'ALWAYS APPLY' | 'IGNORE' | 'PROVISION ONLY', required - `allow_google_assistant` boolean, required - `factory_reset_protection_settings` object, required - `apply_policy` 'ALWAYS APPLY' | 'IGNORE' | 'PROVISION ONLY', required - `google_id` string, required - `email` string, 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 - `apply_policy` 'ALWAYS APPLY' | 'IGNORE' | 'PROVISION ONLY' - `alarm_volume` integer - `music_settings` object - `apply_policy` 'ALWAYS APPLY' | 'IGNORE' | 'PROVISION ONLY' - `music_volume` integer - `ringtone_settings` object - `apply_policy` 'ALWAYS APPLY' | 'IGNORE' | 'PROVISION ONLY' - `ringtone_volume` integer - `notification_settings` object - `apply_policy` 'ALWAYS APPLY' | 'IGNORE' | 'PROVISION ONLY' - `notification_volume` integer - `voice_call_settings` object - `apply_policy` 'ALWAYS APPLY' | 'IGNORE' | 'PROVISION ONLY' - `voice_call_volume` integer - `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[] - `type` 'SINGLE_APP' - `name` string - `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). - `datawedge_settings` BlueprintsDatawedgeSettings — DataWedge barcode scanning configuration for Zebra devices. - … - `mx_config_settings` BlueprintsMxConfigSettings — MX Config settings — supports file upload, content management, and XML paste. - … - `oem_config_settings` BlueprintsOemConfigSettings — OEM Config settings with version picker and configuration options. - … - `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 - `apply_policy` 'ALWAYS APPLY' | 'IGNORE' | 'PROVISION ONLY' - `portrait` object - … - `lockscreen` object - `apply_policy` 'ALWAYS APPLY' | 'IGNORE' | 'PROVISION ONLY' - `portrait` 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[] - `apply_policy` 'ALWAYS APPLY' | 'IGNORE' | 'PROVISION ONLY', required - `script` string, required — The shell script to be executed. - `interpreter` string, required — The interpreter to use for the script (e.g., bash). - `alias` string, required — A user-friendly name or alias for the script. - `description` string — A description of what the script does. - `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. - `id` string, uuid, required — The UUID of the custom action to apply. - `options_key` string, uuid, required — The UUID of the specific option key within the Custom Action to use. - `apply_policy` 'ALWAYS APPLY' | 'IGNORE' | 'PROVISION ONLY', required - `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 - `apply_policy` 'ALWAYS APPLY' | 'IGNORE' | 'PROVISION ONLY', required - `time` integer, required — Start hour in 24-hour format (0-23) - `active_hours_end` object, required — End time for active hours - `apply_policy` 'ALWAYS APPLY' | 'IGNORE' | 'PROVISION ONLY', required - `time` integer, required — End hour in 24-hour format (0-23) - `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[] - `apply_policy` 'ALWAYS APPLY' | 'IGNORE' | 'PROVISION ONLY', required - `script` string, required — The PowerShell script to be executed. - `interpreter` string, required — The interpreter to use for the script (e.g., powershell). - `alias` string, required — A user-friendly name or alias for the script. - `description` string — A description of what the script does. - `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 - `apply_policy` 'ALWAYS APPLY' | 'IGNORE' | 'PROVISION ONLY', required - `defer_days` integer, required — Number of days to defer quality updates - `feature_updates` object, required — Feature updates deferral settings - `apply_policy` 'ALWAYS APPLY' | 'IGNORE' | 'PROVISION ONLY', required - `defer_days` integer, required — Number of days to defer feature updates - `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. - `name` string — Name of the kiosk profile - `desktop_app_path` string — Absolute path to the kiosk desktop app executable (required) - `auto_launch` boolean — Automatically launch the app - `auto_launch_arguments` string — Arguments passed to the app on launch - `hide_taskbar` boolean — Hide Windows taskbar - `hide_start_recommended_section` boolean — Hide Recommended section from Start menu - `hide_power_button` boolean — Hide power button in Start menu - `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. - `app_id` string, uuid, required — UUID of the UWP app. Must be present 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. - `apply_policy` 'ALWAYS APPLY' | 'IGNORE' | 'PROVISION ONLY', required - `day` 'EVERY_DAY' | 'SUNDAY' | 'MONDAY' | 'TUESDAY' | 'WEDNESDAY' | 'THURSDAY' | 'FRIDAY' | 'SATURDAY', nullable - `scheduled_install_week` object — Week of the month for scheduled install. Maps to Update/ScheduledInstall*Week CSPs. - `apply_policy` 'ALWAYS APPLY' | 'IGNORE' | 'PROVISION ONLY', required - `week` 'ALL' | 'FIRST' | 'SECOND' | 'THIRD' | 'FOURTH', nullable - `scheduled_install_time` object — Hour of day for scheduled install (0 = 12 AM, 23 = 11 PM). Maps to Update/ScheduledInstallTime CSP. - `apply_policy` 'ALWAYS APPLY' | 'IGNORE' | 'PROVISION ONLY', required - `time` integer, nullable - `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 - `apply_policy` 'ALWAYS APPLY' | 'IGNORE' | 'PROVISION ONLY' - `landscape` object — Landscape wallpaper configuration - … - `lockscreen` object — Wallpaper settings for the Windows lock screen - `apply_policy` 'ALWAYS APPLY' | 'IGNORE' | 'PROVISION ONLY' - `landscape` object — Landscape wallpaper configuration - … - `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` string ## Other responses - `404` — Resouce not found --- [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/versions/e1f64cbb488e/schema)