---
title: "Create a Blueprint"
method: POST
path: "/enterprise/{enterprise_id}/devicegroup/{group_id}/blueprint/"
tags: ["esper_cloud_api_Blueprint (Deprecated)"]
---

# Create a Blueprint

`POST /enterprise/{enterprise_id}/devicegroup/{group_id}/blueprint/`

Returns the created Blueprint instance.

⚠️ **Deprecation Notice:** This endpoint will soon be deprecated. Use [Blueprints API](https://api.esper.io/tag/Blueprints-API) instead.

## Path parameters

- `enterprise_id` string, uuid, required
- `group_id` string, uuid, required

## Query parameters

- `without_details` boolean

## Request body

- EsperCloudApiBlueprint
  - `id` string, uuid
  - `name` string
  - `description` string
  - `locked` boolean
  - `group` string, uuid
  - `latest_revision` EsperCloudApiBlueprintRevision
    - `id` string, uuid
    - `revision` string
    - `created_by` string
    - `current` boolean
    - `type` 'Independent' | 'Inherited'
    - `comments` string
    - `locked` boolean
    - `connectivity` EsperCloudApiConnectivitySection
      - `sms_disabled` boolean
      - `enable_bluetooth` boolean
      - `wifi_state` boolean
      - `nfc_beam_disabled` boolean
      - `ethernet_settings` object — Ethernet settings to configure ethernet certificate
        - `ethernet_auth_mode` 'EAP_TLS' | 'NONE', required — Auth Mode options ``` * EAP_TLS: Ethernet auth mode is EAP_TLS * NONE: Default Value, if NONE then other fields are option ```
        - `ethernet_ca_cert_alias` string — It is mandatory field if Auth Mode is “EAP_TLS”.
        - `ethernet_client_cert_alias` string — It is mandatory field if Auth Mode is “EAP_TLS”.
        - `ethernet_eap_identity` string — It is mandatory field if Auth Mode is “EAP_TLS”.
      - `wifi_settings` object[]
        - `wifi_ssid` string
        - `wifi_password` string
        - `wifi_security_type` 'NONE' | 'WAP' | 'WEP' | 'EAP' | 'WPA2' | 'SAE'
        - `wifi_phase2_auth` 'NONE' | 'PAP' | 'MSCHAP' | 'MSCHAPV2' | 'GTC' | 'SIM' | 'AKA' | 'AKA_PRIME'
        - `wifi_eap_method` 'PEAP' | 'TLS' | 'TTLS' | 'PWD' | 'NONE' | 'SIM' | 'AKA' | 'AKA_PRIME'
        - `identity` string
        - `anonymous_identity` string
        - `domain` string
        - `hidden` boolean
      - `incoming_numbers_with_tags` object[]
        - `number` string
        - `tags` string[]
      - `outgoing_numbers_with_tags` object[]
        - `number` string
        - `tags` string[]
      - `section_type` 'Inherited' | 'Independent'
      - `locked` boolean — Locked
    - `sound` EsperCloudApiSoundSection
      - `alarm_volume` integer
      - `notification_volume` integer
      - `music_volume` integer
      - `ring_volume` integer
      - `section_type` 'Inherited' | 'Independent'
      - `locked` boolean — Locked
    - `display_branding` EsperCloudApiDisplayBrandingSection
      - `screenshot_disabled` boolean
      - `status_bar_disabled` boolean
      - `rotation_state` 'AUTO' | 'LANDSCAPE_ONLY' | 'POTRAIT_ONLY' | 'INVERTED_PORTRAIT_ONLY' | 'INVERTED_LANDSCAPE_ONLY'
      - `brightness_scale` integer
      - `wallpapers` object[]
        - `wallpaper` string, uuid
        - `wallpaper_url` string
        - `thumbnail_url` string
        - `orientation` string
        - `screen_types` string[]
        - `orientations` string[]
      - `section_type` 'Inherited' | 'Independent'
      - `locked` boolean — Locked
    - `hardware_settings` EsperCloudApiHardwareSettingsSection
      - `gps_state` 'LOCATION_MODE_HIGH_ACCURACY' | 'LOCATION_MODE_SENSORS_ONLY' | 'LOCATION_MODE_BATTERY_SAVING' | 'LOCATION_MODE_OFF' | 'LOCATION_MODE_ON'
      - `usb_file_transfer_disabled` boolean
      - `tethering_disabled` boolean
      - `camera_disabled` boolean
      - `usb_connectivity_disabled` boolean
      - `section_type` 'Inherited' | 'Independent'
      - `locked` boolean — Locked
    - `date_time` EsperCloudApiDateTimeSection
      - `timezone_string` string
      - `device_locale` string
      - `date_time_config_disabled` boolean
      - `section_type` 'Inherited' | 'Independent'
      - `locked` boolean — Locked
    - `settings_app` EsperCloudApiSettingsAppSection
      - `enable_android_settings_app` boolean
      - `settings_access_level` 'NONE' | 'SHOONYA' | 'SYSTEM'
      - `esper_settings_app` object
        - `only_dock_accessible` boolean
        - `admin_mode_password` string
        - `esper_settings_app_policy` object
          - `flashlight` string
          - `wifi` string
          - `auto_rotation` string
          - `reboot` string
          - `kiosk_app_selection` string
          - `esper_branding` string
          - `factory_reset` string
          - `about` string
          - `display` string
          - `sound` string
          - `keyboard` string
          - `input_selection` string
          - `accessibility` string
          - `mobile_data` string
          - `bluetooth` string
          - `language` string
          - `time_and_date` string
          - `clear_app_data` string
          - `storage` string
          - `data_roaming` string
          - `wifi_tethering` string
          - `airplane_mode` string
          - `accessibility_reset_to_default` string
          - `accessibility_high_contrast_text` string
          - `accessibility_cc_deuteranomaly` string
          - `accessibility_cc_protanomaly` string
          - `accessibility_cc_tritanomaly` string
          - `accessibility_mono_audio` string
          - `accessibility_display_size` string
          - `accessibility_talkback` string
          - `accessibility_text_to_speech` string
      - `config_json` object
      - `section_type` 'Inherited' | 'Independent'
      - `locked` boolean — Locked
    - `system_updates` EsperCloudApiSystemUpdatesSection
      - `locked` boolean — Locked
      - `section_type` 'Inherited' | 'Independent'
      - `type` 'TYPE_POSTPONE' | 'TYPE_INSTALL_AUTOMATIC' | 'TYPE_INSTALL_WINDOWED' | 'TYPE_INSTALL_DISABLED' — Type
      - `maintenance_start` integer
      - `maintenance_end` integer
    - `google_services` EsperCloudApiGoogleServicesSection
      - `disable_play_store` boolean
      - `google_assistant_disabled` boolean
      - `managed_google_play_disabled` boolean
      - `max_account` integer
      - `emails` string[]
      - `domains` string[]
      - `frp_googles` object[]
        - `google_id` string
        - `email` string
        - `type` 'USER' | 'ADMIN'
      - `section_type` 'Inherited' | 'Independent'
      - `locked` boolean — Locked
    - `security` EsperCloudApiSecuritySection
      - `password_quality` 'PASSWORD_QUALITY_ALPHABETIC' | 'PASSWORD_QUALITY_ALPHANUMERIC' | 'PASSWORD_QUALITY_UNSPECIFIED' | 'PASSWORD_QUALITY_COMPLEX' | 'PASSWORD_QUALITY_BIOMETRIC_WEAK' | 'PASSWORD_QUALITY_NUMERIC'
      - `minimum_password_length` integer
      - `adb_disabled` boolean
      - `safe_boot_disabled` boolean
      - `screen_off_timeout` integer
      - `factory_reset_disabled` boolean
      - `keyguard_disabled` boolean
      - `section_type` 'Inherited' | 'Independent'
      - `locked` boolean — Locked
    - `application` EsperCloudApiApplicationSection
      - `app_mode` 'KIOSK' | 'MULTI_APP'
      - `launch_on_start` string
      - `start_on_boot` string, nullable
      - `launcher_less_dpc` boolean
      - `disable_local_app_install` boolean
      - `app_uninstall_disabled` boolean
      - `permission_policy` 'PERMISSION_POLICY_AUTO_GRANT' | 'PERMISSION_POLICY_PROMPT' | 'PERMISSION_POLICY_AUTO_DENY'
      - `locked` boolean — Locked
      - `preload_apps` object[]
        - `package_name` string
        - `state` 'SHOW' | 'HIDE' | 'DISABLED' | 'LAUNCHABLE_BUT_HIDDEN'
      - `apps` object[]
        - `version_codes` string[]
        - `is_g_play` boolean
        - `app_version` string, uuid
        - `app_version_url` string
        - `hash_string` string
        - `package_name` string
        - `download_url` string
        - `installation_rule` 'DURING' | 'POST'
        - `state` 'SHOW' | 'HIDE' | 'DISABLED' | 'LAUNCHABLE_BUT_HIDDEN'
        - `managed_config` object
      - `section_type` 'Inherited' | 'Independent'
    - `content` EsperCloudApiContentSection
      - `files` object[]
        - `file` integer
        - `file_url` string
        - `hash` string
        - `url` string
        - `destination_path` string
      - `section_type` 'Inherited' | 'Independent'
      - `locked` boolean
    - `created_on` string, date-time — Date and time of when the group was created
  - `created_on` string, date-time
  - `updated_on` string, date-time

## Response `201`

Created

- EsperCloudApiBlueprint
  - `id` string, uuid
  - `name` string
  - `description` string
  - `locked` boolean
  - `group` string, uuid
  - `latest_revision` EsperCloudApiBlueprintRevision
    - `id` string, uuid
    - `revision` string
    - `created_by` string
    - `current` boolean
    - `type` 'Independent' | 'Inherited'
    - `comments` string
    - `locked` boolean
    - `connectivity` EsperCloudApiConnectivitySection
      - `sms_disabled` boolean
      - `enable_bluetooth` boolean
      - `wifi_state` boolean
      - `nfc_beam_disabled` boolean
      - `ethernet_settings` object — Ethernet settings to configure ethernet certificate
        - `ethernet_auth_mode` 'EAP_TLS' | 'NONE', required — Auth Mode options ``` * EAP_TLS: Ethernet auth mode is EAP_TLS * NONE: Default Value, if NONE then other fields are option ```
        - `ethernet_ca_cert_alias` string — It is mandatory field if Auth Mode is “EAP_TLS”.
        - `ethernet_client_cert_alias` string — It is mandatory field if Auth Mode is “EAP_TLS”.
        - `ethernet_eap_identity` string — It is mandatory field if Auth Mode is “EAP_TLS”.
      - `wifi_settings` object[]
        - `wifi_ssid` string
        - `wifi_password` string
        - `wifi_security_type` 'NONE' | 'WAP' | 'WEP' | 'EAP' | 'WPA2' | 'SAE'
        - `wifi_phase2_auth` 'NONE' | 'PAP' | 'MSCHAP' | 'MSCHAPV2' | 'GTC' | 'SIM' | 'AKA' | 'AKA_PRIME'
        - `wifi_eap_method` 'PEAP' | 'TLS' | 'TTLS' | 'PWD' | 'NONE' | 'SIM' | 'AKA' | 'AKA_PRIME'
        - `identity` string
        - `anonymous_identity` string
        - `domain` string
        - `hidden` boolean
      - `incoming_numbers_with_tags` object[]
        - `number` string
        - `tags` string[]
      - `outgoing_numbers_with_tags` object[]
        - `number` string
        - `tags` string[]
      - `section_type` 'Inherited' | 'Independent'
      - `locked` boolean — Locked
    - `sound` EsperCloudApiSoundSection
      - `alarm_volume` integer
      - `notification_volume` integer
      - `music_volume` integer
      - `ring_volume` integer
      - `section_type` 'Inherited' | 'Independent'
      - `locked` boolean — Locked
    - `display_branding` EsperCloudApiDisplayBrandingSection
      - `screenshot_disabled` boolean
      - `status_bar_disabled` boolean
      - `rotation_state` 'AUTO' | 'LANDSCAPE_ONLY' | 'POTRAIT_ONLY' | 'INVERTED_PORTRAIT_ONLY' | 'INVERTED_LANDSCAPE_ONLY'
      - `brightness_scale` integer
      - `wallpapers` object[]
        - `wallpaper` string, uuid
        - `wallpaper_url` string
        - `thumbnail_url` string
        - `orientation` string
        - `screen_types` string[]
        - `orientations` string[]
      - `section_type` 'Inherited' | 'Independent'
      - `locked` boolean — Locked
    - `hardware_settings` EsperCloudApiHardwareSettingsSection
      - `gps_state` 'LOCATION_MODE_HIGH_ACCURACY' | 'LOCATION_MODE_SENSORS_ONLY' | 'LOCATION_MODE_BATTERY_SAVING' | 'LOCATION_MODE_OFF' | 'LOCATION_MODE_ON'
      - `usb_file_transfer_disabled` boolean
      - `tethering_disabled` boolean
      - `camera_disabled` boolean
      - `usb_connectivity_disabled` boolean
      - `section_type` 'Inherited' | 'Independent'
      - `locked` boolean — Locked
    - `date_time` EsperCloudApiDateTimeSection
      - `timezone_string` string
      - `device_locale` string
      - `date_time_config_disabled` boolean
      - `section_type` 'Inherited' | 'Independent'
      - `locked` boolean — Locked
    - `settings_app` EsperCloudApiSettingsAppSection
      - `enable_android_settings_app` boolean
      - `settings_access_level` 'NONE' | 'SHOONYA' | 'SYSTEM'
      - `esper_settings_app` object
        - `only_dock_accessible` boolean
        - `admin_mode_password` string
        - `esper_settings_app_policy` object
          - `flashlight` string
          - `wifi` string
          - `auto_rotation` string
          - `reboot` string
          - `kiosk_app_selection` string
          - `esper_branding` string
          - `factory_reset` string
          - `about` string
          - `display` string
          - `sound` string
          - `keyboard` string
          - `input_selection` string
          - `accessibility` string
          - `mobile_data` string
          - `bluetooth` string
          - `language` string
          - `time_and_date` string
          - `clear_app_data` string
          - `storage` string
          - `data_roaming` string
          - `wifi_tethering` string
          - `airplane_mode` string
          - `accessibility_reset_to_default` string
          - `accessibility_high_contrast_text` string
          - `accessibility_cc_deuteranomaly` string
          - `accessibility_cc_protanomaly` string
          - `accessibility_cc_tritanomaly` string
          - `accessibility_mono_audio` string
          - `accessibility_display_size` string
          - `accessibility_talkback` string
          - `accessibility_text_to_speech` string
      - `config_json` object
      - `section_type` 'Inherited' | 'Independent'
      - `locked` boolean — Locked
    - `system_updates` EsperCloudApiSystemUpdatesSection
      - `locked` boolean — Locked
      - `section_type` 'Inherited' | 'Independent'
      - `type` 'TYPE_POSTPONE' | 'TYPE_INSTALL_AUTOMATIC' | 'TYPE_INSTALL_WINDOWED' | 'TYPE_INSTALL_DISABLED' — Type
      - `maintenance_start` integer
      - `maintenance_end` integer
    - `google_services` EsperCloudApiGoogleServicesSection
      - `disable_play_store` boolean
      - `google_assistant_disabled` boolean
      - `managed_google_play_disabled` boolean
      - `max_account` integer
      - `emails` string[]
      - `domains` string[]
      - `frp_googles` object[]
        - `google_id` string
        - `email` string
        - `type` 'USER' | 'ADMIN'
      - `section_type` 'Inherited' | 'Independent'
      - `locked` boolean — Locked
    - `security` EsperCloudApiSecuritySection
      - `password_quality` 'PASSWORD_QUALITY_ALPHABETIC' | 'PASSWORD_QUALITY_ALPHANUMERIC' | 'PASSWORD_QUALITY_UNSPECIFIED' | 'PASSWORD_QUALITY_COMPLEX' | 'PASSWORD_QUALITY_BIOMETRIC_WEAK' | 'PASSWORD_QUALITY_NUMERIC'
      - `minimum_password_length` integer
      - `adb_disabled` boolean
      - `safe_boot_disabled` boolean
      - `screen_off_timeout` integer
      - `factory_reset_disabled` boolean
      - `keyguard_disabled` boolean
      - `section_type` 'Inherited' | 'Independent'
      - `locked` boolean — Locked
    - `application` EsperCloudApiApplicationSection
      - `app_mode` 'KIOSK' | 'MULTI_APP'
      - `launch_on_start` string
      - `start_on_boot` string, nullable
      - `launcher_less_dpc` boolean
      - `disable_local_app_install` boolean
      - `app_uninstall_disabled` boolean
      - `permission_policy` 'PERMISSION_POLICY_AUTO_GRANT' | 'PERMISSION_POLICY_PROMPT' | 'PERMISSION_POLICY_AUTO_DENY'
      - `locked` boolean — Locked
      - `preload_apps` object[]
        - `package_name` string
        - `state` 'SHOW' | 'HIDE' | 'DISABLED' | 'LAUNCHABLE_BUT_HIDDEN'
      - `apps` object[]
        - `version_codes` string[]
        - `is_g_play` boolean
        - `app_version` string, uuid
        - `app_version_url` string
        - `hash_string` string
        - `package_name` string
        - `download_url` string
        - `installation_rule` 'DURING' | 'POST'
        - `state` 'SHOW' | 'HIDE' | 'DISABLED' | 'LAUNCHABLE_BUT_HIDDEN'
        - `managed_config` object
      - `section_type` 'Inherited' | 'Independent'
    - `content` EsperCloudApiContentSection
      - `files` object[]
        - `file` integer
        - `file_url` string
        - `hash` string
        - `url` string
        - `destination_path` string
      - `section_type` 'Inherited' | 'Independent'
      - `locked` boolean
    - `created_on` string, date-time — Date and time of when the group was created
  - `created_on` string, date-time
  - `updated_on` string, date-time

## Other responses

- `400` — Blueprint create error
- `401` — Blueprint create error

---

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