# Retrieve all blueprints Retrieve all blueprints Endpoint: GET /v2/blueprints/ Version: 1.0.0 ## Query parameters: - `ordering` (string) Order the results by a specific field (-field for descending order), Combine Multiple with , like -created_at,-updated_at. - `name` (string) Filter the results by name, case insensitive - `name_exact` (string) Filter the results by name, case sensitive and matches exact name - `settings__android__app_id` (string) List the blueprints which have given app_id in any of the versions for android apps. - `settings__android__app_version_id` (string) List the blueprints which have given app_version_id in any of the versions for android apps. - `settings__ios__app_id` (string) List the blueprints which have given app_id in any of the versions for ios apps. - `settings__ios__app_version_id` (string) List the blueprints which have given app_version_id in any of the versions for ios apps. - `settings__windows__app_id` (string) List the blueprints which have given app_id in any of the versions for windows apps. - `settings__windows__app_version_id` (string) List the blueprints which have given app_version_id in any of the versions for windows apps. - `settings__android__file_id` (string) List the blueprints which have given file_id in any of the versions. - `settings__android__wifi_network_id` (string) List the blueprints which have given wifi_network_id in any of the versions. - `settings__ios__provisioning_profile_id` (string) Filter blueprints that have the given provisioning profile ID in any version. - `settings__ios__provisioning_profile_version_id` (string) Filter blueprints that have the given provisioning profile version ID in any version. ## Response 200 fields (application/json): - `content` (object) - `content.count` (integer) The number of objects in the result set - `content.next` (string) The link to retrieve the next set of objects in the result set - `content.previous` (string) The link to retrieve the previous set of objects in the result set - `content.results` (array) - `content.results.id` (string) - `content.results.name` (string) Name of the blueprint - `content.results.description` (string) Description of the blueprint - `content.results.comments` (string) Comments on the blueprint - `content.results.version_number` (integer) - `content.results.version_id` (string) - `content.results.minor_version_number` (integer) - `content.results.publish` (boolean) - `content.results.settings` (object) - `content.results.settings.android` (object) - `content.results.settings.android.device_mode_settings` (object) - `content.results.settings.android.device_mode_settings.apply_policy` (string) Enum: "ALWAYS APPLY", "IGNORE", "PROVISION ONLY" - `content.results.settings.android.device_mode_settings.device_mode` (string) Enum: "KIOSK", "MULTI APP" - `content.results.settings.android.launcher_settings` (object) - `content.results.settings.android.launcher_settings.launcher` (string, required) Enum: "ESPER", "DEFAULT" - `content.results.settings.android.local_app_install_settings` (object) - `content.results.settings.android.local_app_install_settings.allow_local_app_install` (boolean, required) - `content.results.settings.android.app_uninstall_settings` (object) - `content.results.settings.android.app_uninstall_settings.allow_app_uninstallation` (boolean, required) - `content.results.settings.android.app_permission_policy_settings` (object) - `content.results.settings.android.app_permission_policy_settings.permission_policy` (string, required) Enum: "ALLOW AUTOMATICALLY", "DENY", "ASK USER" - `content.results.settings.android.wifi_settings` (object) - `content.results.settings.android.wifi_settings.allow_wifi` (boolean, required) - `content.results.settings.android.wifi_settings.wifi_state` (string, required) Enum: "ENABLE", "DISABLE" - `content.results.settings.android.bluetooth_settings` (object) - `content.results.settings.android.bluetooth_settings.allow_bluetooth` (boolean, required) - `content.results.settings.android.bluetooth_settings.bluetooth_state` (string) Enum: "ENABLE", "DISABLE" - `content.results.settings.android.bluetooth_settings.drift_policy` (string) Allowed values: IGNORE, LOG ONLY, MINOR, MAJOR, CRITICAL Enum: "IGNORE", "LOG ONLY", "MINOR", "MAJOR", "CRITICAL" - `content.results.settings.android.sms_settings` (object) - `content.results.settings.android.sms_settings.allow_sms` (boolean, required) - `content.results.settings.android.nfc_settings` (object) - `content.results.settings.android.nfc_settings.allow_nfc` (boolean, required) - `content.results.settings.android.incoming_numbers_settings` (object) - `content.results.settings.android.incoming_numbers_settings.allow_all_numbers` (boolean, required) - `content.results.settings.android.incoming_numbers_settings.allowed_numbers` (array) - `content.results.settings.android.incoming_numbers_settings.tags` (array) - `content.results.settings.android.outgoing_numbers_settings` (object) - `content.results.settings.android.outgoing_numbers_settings.allow_ussd_codes` (boolean) - `content.results.settings.android.ethernet_settings` (object) - `content.results.settings.android.ethernet_settings.auth_mode` (string) Enum: "NONE", "EAP-TLS" - `content.results.settings.android.ethernet_settings.ca_cert_alias` (string) - `content.results.settings.android.ethernet_settings.client_cert_alias` (string) - `content.results.settings.android.ethernet_settings.eap_identity` (string) - `content.results.settings.android.adb_settings` (object) - `content.results.settings.android.adb_settings.allow_adb` (boolean, required) - `content.results.settings.android.safe_boot_settings` (object) - `content.results.settings.android.safe_boot_settings.allow_safe_boot` (boolean, required) - `content.results.settings.android.factory_reset_settings` (object) - `content.results.settings.android.factory_reset_settings.allow_factory_reset` (boolean, required) - `content.results.settings.android.screen_timeout_settings` (object) - `content.results.settings.android.screen_timeout_settings.screentimeout_value` (integer, required) - `content.results.settings.android.lock_screen_settings` (object) - `content.results.settings.android.lock_screen_settings.password_quality` (string, required) Enum: "NONE", "ALPHABETIC", "NUMERIC", "ALPHANUMERIC", "COMPLEX", "BIOMETRIC_WEAK" - `content.results.settings.android.lock_screen_settings.minimum_password_length` (integer,null) - `content.results.settings.android.lock_screen_settings.allow_keyguard` (boolean, required) - `content.results.settings.android.brightness_settings` (object) - `content.results.settings.android.brightness_settings.brightness_value` (string) - `content.results.settings.android.screen_orientation_settings` (object) - `content.results.settings.android.screen_orientation_settings.orientation_type` (string) Enum: "PORTRAIT", "LANDSCAPE", "INVERTED PORTRAIT", "INVERTED LANDSCAPE", "AUTO" - `content.results.settings.android.screenshot_settings` (object) - `content.results.settings.android.screenshot_settings.allow_screenshot` (boolean) - `content.results.settings.android.notification_bar_settings` (object) - `content.results.settings.android.notification_bar_settings.allow_notification_bar` (boolean) - `content.results.settings.android.wallpaper_settings` (object) - `content.results.settings.android.wallpaper_settings.homescreen` (object) - `content.results.settings.android.wallpaper_settings.homescreen.portrait` (object) - `content.results.settings.android.wallpaper_settings.homescreen.portrait.wallpaper_id` (string) - `content.results.settings.android.wallpaper_settings.homescreen.landscape` (object) - `content.results.settings.android.wallpaper_settings.lockscreen` (object) - `content.results.settings.android.esper_settings_apps_settings` (object) - `content.results.settings.android.esper_settings_apps_settings.allow_dock` (boolean) - `content.results.settings.android.esper_settings_apps_settings.admin_mode_password` (string) - `content.results.settings.android.esper_settings_apps_settings.allow_esper_settings_app` (boolean) - `content.results.settings.android.android_settings_app_settings` (object) - `content.results.settings.android.android_settings_app_settings.allow_android_settings_app` (boolean, required) - `content.results.settings.android.customized_device_level_json_settings` (object) - `content.results.settings.android.customized_device_level_json_settings.customized_json` (object, required) - `content.results.settings.android.google_services_settings` (object) - `content.results.settings.android.google_services_settings.afw_account_settings` (object, required) - `content.results.settings.android.google_services_settings.afw_account_settings.allow_afw_account_addition` (boolean, required) - `content.results.settings.android.google_services_settings.personal_accounts_settings` (object, required) - `content.results.settings.android.google_services_settings.personal_accounts_settings.personal_accounts_limit_value` (integer, required) - `content.results.settings.android.google_services_settings.play_store_settings` (object, required) - `content.results.settings.android.google_services_settings.play_store_settings.allow_playstore` (boolean, required) - `content.results.settings.android.google_services_settings.google_assitant_settings` (object, required) - `content.results.settings.android.google_services_settings.google_assitant_settings.allow_google_assistant` (boolean, required) - `content.results.settings.android.google_services_settings.factory_reset_protection_settings` (object, required) - `content.results.settings.android.google_services_settings.factory_reset_protection_settings.google_id` (string, required) - `content.results.settings.android.google_services_settings.factory_reset_protection_settings.email` (string, required) - `content.results.settings.android.external_device_settings` (object) - `content.results.settings.android.external_device_settings.allow_external_device_mount` (boolean) - `content.results.settings.android.usb_tethering_settings` (object) - `content.results.settings.android.usb_tethering_settings.allow_usb_tethering` (boolean) - `content.results.settings.android.file_transfer_settings` (object) - `content.results.settings.android.file_transfer_settings.allow_file_transfer` (boolean) - `content.results.settings.android.camera_settings` (object) - `content.results.settings.android.camera_settings.allow_camera_access` (boolean) - `content.results.settings.android.location_settings` (object) - `content.results.settings.android.location_settings.allow_location` (boolean) - `content.results.settings.android.sound_settings` (object) - `content.results.settings.android.sound_settings.alarm_settings` (object) - `content.results.settings.android.sound_settings.alarm_settings.alarm_volume` (integer) - `content.results.settings.android.sound_settings.music_settings` (object) - `content.results.settings.android.sound_settings.music_settings.music_volume` (integer) - `content.results.settings.android.sound_settings.ringtone_settings` (object) - `content.results.settings.android.sound_settings.ringtone_settings.ringtone_volume` (integer) - `content.results.settings.android.sound_settings.notification_settings` (object) - `content.results.settings.android.sound_settings.notification_settings.notification_volume` (integer) - `content.results.settings.android.sound_settings.voice_call_settings` (object) - `content.results.settings.android.sound_settings.voice_call_settings.voice_call_volume` (integer) - `content.results.settings.android.system_updates_settings` (object) - `content.results.settings.android.system_updates_settings.system_update_policy_type` (string) Enum: "UPDATE AUTOMATICALLY", "POSTPONE INSTALLATION", "WINDOWED INSTALLATION", "DISABLE UPDATE", "DEFAULT UPDATE" - `content.results.settings.android.system_updates_settings.maintenance_start` (string) - `content.results.settings.android.system_updates_settings.maintenance_end` (string) - `content.results.settings.android.time_date_settings` (object) - `content.results.settings.android.time_date_settings.allow_edit_time_date` (boolean) - `content.results.settings.android.timezone_settings` (object) - `content.results.settings.android.timezone_settings.timezone` (string) - `content.results.settings.android.language_settings` (object) - `content.results.settings.android.language_settings.device_locale` (string) - `content.results.settings.android.strict_wifi_synchronization_settings` (object) - `content.results.settings.android.strict_wifi_synchronization_settings.allow_strict_wifi_synchronization` (boolean) - `content.results.settings.android.strict_app_synchronization_settings` (object) - `content.results.settings.android.strict_app_synchronization_settings.allow_strict_app_synchronization` (boolean) - `content.results.settings.android.apps` (array) - `content.results.settings.android.apps.app_id` (string, required) - `content.results.settings.android.apps.app_version_id` (string, required) - `content.results.settings.android.apps.package_name` (string, required) - `content.results.settings.android.apps.installation_rule` (string, required) Enum: "POST PROVISIONING", "DURING PROVISIONING" - `content.results.settings.android.apps.state` (string, required) Enum: "SHOW", "HIDE", "DISABLE", "LAUNCHABLE_BUT_HIDDEN" - `content.results.settings.android.apps.managed_config` (object) - `content.results.settings.android.apps.type` (string, required) Enum: "PRELOADED", "ENTERPRISE", "PLAYSTORE" - `content.results.settings.android.apps.auto_update_mode` (string, required) Enum: "autoUpdateDefault", "autoUpdateHighPriority", "autoUpdatePostponed" - `content.results.settings.android.files` (array) - `content.results.settings.android.files.file_id` (string, required) - `content.results.settings.android.files.destination_path` (string, required) - `content.results.settings.android.wifi_networks` (array) - `content.results.settings.android.wifi_networks.wifi_network_id` (string, required) - `content.results.settings.android.wifi_networks.certificate_file_path` (string) Example: "/storage/emulated/0/Documents" - `content.results.settings.android.wifi_networks.certificate_file_password` (string) Example: "abc" - `content.results.settings.android.saved_ap_settings` (object) - `content.results.settings.android.saved_ap_settings.use_only_saved_ap` (boolean, required) - `content.results.settings.android.mac_address_randomization_settings` (object) - `content.results.settings.android.mac_address_randomization_settings.allow_mac_address_randomization` (boolean) - `content.results.settings.android.esper_edgebox_settings` (object) - `content.results.settings.android.esper_edgebox_settings.allow_esper_edgebox` (boolean) - `content.results.settings.android.app_layout_setting` (object) - `content.results.settings.android.app_layout_setting.brand_logo_position` (string) Enum: "BOTTOM_LEFT", "BOTTOM_RIGHT", "TOP_LEFT", "TOP_RIGHT" - `content.results.settings.android.app_layout_setting.device_name_position` (string) Enum: "BOTTOM_LEFT", "BOTTOM_RIGHT", "TOP_LEFT", "TOP_RIGHT" - `content.results.settings.android.app_layout_setting.app_icon_size` (string) Enum: "SMALL_ICON", "MEDIUM_ICON", "LARGE_ICON", "DEFAULT_ICON", "CUSTOM_ICON" - `content.results.settings.android.app_layout_setting.app_name_size` (string) Enum: "SMALL_TEXT", "MEDIUM_TEXT", "LARGE_TEXT", "DEFAULT_TEXT", "CUSTOM_TEXT" - `content.results.settings.android.app_layout_setting.device_name_and_id_display_policy` (string) Enum: "NONE", "DEFAULT", "DEVICE_ID_ONLY", "ALIAS_NAME_ONLY", "DEVICE_ID_AND_ALIAS_NAME" - `content.results.settings.android.app_layout_setting.device_name_size` (string) Enum: "SMALL_TEXT", "MEDIUM_TEXT", "LARGE_TEXT", "DEFAULT_TEXT", "CUSTOM_TEXT" - `content.results.settings.android.app_layout_setting.device_alias_size` (string) Enum: "SMALL_TEXT", "MEDIUM_TEXT", "LARGE_TEXT", "DEFAULT_TEXT", "CUSTOM_TEXT" - `content.results.settings.android.app_layout_setting.custom_app_icon_size` (integer) - `content.results.settings.android.app_layout_setting.custom_device_name_size` (integer) - `content.results.settings.android.app_layout_setting.custom_device_alias_size` (integer) - `content.results.settings.android.app_layout_setting.custom_app_name_size` (integer) - `content.results.settings.android.app_order_setting` (object) - `content.results.settings.android.app_order_setting.app_order_list` (array) - `content.results.settings.android.app_order_setting.app_order_list.name` (string) - `content.results.settings.ios` (object) - `content.results.settings.ios.kiosk_app` (object) - `content.results.settings.ios.kiosk_app.app_type` (string) Enum: "VPP", "TENANT_IOS", "ESPER_IOS", "WEBCLIP", "PRELOADED" - `content.results.settings.ios.custom_device_level_profile_settings` (object) - `content.results.settings.ios.custom_device_level_profile_settings.custom_profile` (string,null) - `content.results.settings.ios.siri_settings` (object) - `content.results.settings.ios.siri_settings.allow_siri` (boolean, required) - `content.results.settings.ios.tethering_settings` (object) - `content.results.settings.ios.tethering_settings.edit_hotspot` (boolean) - `content.results.settings.ios.hide_preloaded_apps_settings` (object) - `content.results.settings.ios.hide_preloaded_apps_settings.hide_preloaded_apps` (boolean) - `content.results.settings.ios.provisioning_profiles` (array) - `content.results.settings.ios.provisioning_profiles.profile_id` (string, required) - `content.results.settings.ios.provisioning_profiles.profile_version_id` (string, required) - `content.results.settings.ios.web_content_settings` (object) - `content.results.settings.ios.web_content_settings.url_blocklist` (array) - `content.results.settings.ios.web_content_settings.url_allowlist` (array) - `content.results.settings.ios.defer_os_updates` (object) - `content.results.settings.ios.defer_os_updates.defer_os_updates_delay` (integer) - `content.results.settings.linux` (object) Configuration settings specific to Linux devices in a blueprint - `content.results.settings.linux.custom_shell_scripts_multiple` (object) - `content.results.settings.linux.custom_shell_scripts_multiple.shell_scripts` (array) - `content.results.settings.linux.custom_shell_scripts_multiple.shell_scripts.script` (string, required) The shell script to be executed. - `content.results.settings.linux.custom_shell_scripts_multiple.shell_scripts.interpreter` (string, required) The interpreter to use for the script (e.g., bash). - `content.results.settings.linux.custom_shell_scripts_multiple.shell_scripts.alias` (string, required) A user-friendly name or alias for the script. - `content.results.settings.linux.custom_shell_scripts_multiple.shell_scripts.description` (string) A description of what the script does. - `content.results.settings.linux.custom_actions_multiple` (object) Collection of custom actions to be applied on Linux devices. - `content.results.settings.linux.custom_actions_multiple.custom_actions` (array) List of custom actions to apply to Linux devices. - `content.results.settings.linux.custom_actions_multiple.custom_actions.id` (string, required) The UUID of the custom action to apply. - `content.results.settings.linux.custom_actions_multiple.custom_actions.options_key` (string, required) The UUID of the specific option key within the Custom Action to use. - `content.results.settings.windows` (object) - `content.results.settings.windows.active_hours_settings` (object) Windows active hours configuration for controlling update installation timing - `content.results.settings.windows.active_hours_settings.active_hours_start` (object, required) Start time for active hours - `content.results.settings.windows.active_hours_settings.active_hours_start.time` (integer, required) Start hour in 24-hour format (0-23) - `content.results.settings.windows.active_hours_settings.active_hours_end` (object, required) End time for active hours - `content.results.settings.windows.active_hours_settings.active_hours_end.time` (integer, required) End hour in 24-hour format (0-23) - `content.results.settings.windows.auto_update_settings` (object) Windows automatic updates configuration - `content.results.settings.windows.auto_update_settings.auto_update_type` (string, required) Type of automatic update behavior - DEFAULT allows system default behavior, OFF disables automatic updates Enum: "DEFAULT", "OFF" - `content.results.settings.windows.defer_os_updates` (object) Windows OS updates deferral configuration with separate quality and feature update controls - `content.results.settings.windows.defer_os_updates.quality_updates` (object, required) Quality updates deferral settings - `content.results.settings.windows.defer_os_updates.quality_updates.defer_days` (integer, required) Number of days to defer quality updates - `content.results.settings.windows.defer_os_updates.feature_updates` (object, required) Feature updates deferral settings - `content.results.settings.windows.defer_os_updates.feature_updates.defer_days` (integer, required) Number of days to defer feature updates - `content.results.settings.windows.kiosk_settings` (object) Windows kiosk configuration settings for single-app Win32 assigned access. - `content.results.settings.windows.kiosk_settings.win32_single_app_config` (object) Win32 single-app kiosk configuration. Defaults applied if not provided. - `content.results.settings.windows.kiosk_settings.win32_single_app_config.name` (string) Name of the kiosk profile - `content.results.settings.windows.kiosk_settings.win32_single_app_config.desktop_app_path` (string) Absolute path to the kiosk desktop app executable (required) - `content.results.settings.windows.kiosk_settings.win32_single_app_config.auto_launch` (boolean) Automatically launch the app - `content.results.settings.windows.kiosk_settings.win32_single_app_config.auto_launch_arguments` (string) Arguments passed to the app on launch - `content.results.settings.windows.kiosk_settings.win32_single_app_config.hide_taskbar` (boolean) Hide Windows taskbar - `content.results.settings.windows.kiosk_settings.win32_single_app_config.hide_start_recommended_section` (boolean) Hide Recommended section from Start menu - `content.results.settings.windows.kiosk_settings.win32_single_app_config.hide_power_button` (boolean) Hide power button in Start menu - `content.results.settings.windows.pause_os_updates` (object) Windows pause OS updates configuration - `content.results.settings.windows.pause_os_updates.pause_os_updates` (boolean, required) Whether to pause OS updates - `content.results.settings.windows.unenrollment_settings` (object) - `content.results.settings.windows.unenrollment_settings.allow_unenrollment_from_device` (boolean, required) - `content.results.settings.windows.wallpaper_settings` (object) Configuration for Windows desktop wallpaper settings including homescreen and lockscreen backgrounds. Uses landscape orientation only. - `content.results.settings.windows.wallpaper_settings.homescreen` (object) Wallpaper settings for the Windows desktop homescreen - `content.results.settings.windows.wallpaper_settings.homescreen.landscape` (object) Landscape wallpaper configuration - `content.results.settings.windows.wallpaper_settings.homescreen.landscape.wallpaper_id` (string,null) Unique identifier for the wallpaper resource - `content.results.settings.windows.wallpaper_settings.lockscreen` (object) Wallpaper settings for the Windows lock screen - `content.results.created_by` (string) ID of the user who created the blueprint - `content.results.updated_by` (string) ID of the user who updated the blueprint - `content.results.created_at` (string) - `content.results.updated_at` (string) - `content.message` (string) - `content.code` (integer)