# Add a new Restrictions payload configuration to an existing profile

Create Windows restriction policy payload

## Endpoints

**POST** `/api/v1/mdm/profiles/{profile_id}/payloads/windowsrestrictionpolicy`

## Request URL

`https://{server-hostname}:8383/api/v1/mdm/profiles/{profile_id}/payloads/windowsrestrictionpolicy`

## Scope

`MDMDeviceMgmt.CREATE`

## Header

`Authorization: d92d4xxxxxxxxxxxxx15f52`

## Request Parameters

### Request Headers

| Parameter | Type | Required | Value |
|---|---|---|---|
| Content-Type | string | Mandatory | `application/json` |
| Accept | string | Mandatory | `application/json` |

### Path Parameters

| Parameter | Type | Required | Description |
|---|---|---|---|
| profile_id | string | Mandatory | Unique identifier of the profile. Obtain from the [Create Profile](https://www.manageengine.com/products/desktop-central/help/api/onpremise/mdm-profiles-create-profile.html) or [Get Profiles](https://www.manageengine.com/products/desktop-central/help/api/onpremise/mdm-profiles-get-profile.html) response |

### Request Body

`application/json`

| Attribute | Type | Required | Description |
|---|---|---|---|
| enforce_device_encription | boolean | Optional | Enforce Device Encription. Default: false |
| disable_sd_card | boolean | Optional | Disable Sd Card. Default: false |
| allow_use_of_camera | boolean | Optional | Allow Use Of Camera. Default: true |
| allow_screen_capture | boolean | Optional | Allow Screen Capture. Default: true |
| allow_store | boolean | Optional | Allow Store. Default: true |
| allow_storage_card | boolean | Optional | Allow Storage Card. Default: true |
| allow_browser | boolean | Optional | Allow Browser. Default: true |
| allow_bluetooth | boolean | Optional | Allow Bluetooth. Default: true |
| allow_telemetry | integer | Optional | Allow Telemetry. Default: 2 |
| allow_nfc | boolean | Optional | Allow Nfc. Default: true |
| allow_usb | boolean | Optional | Allow Usb. Default: true |
| allow_wifi | boolean | Optional | Allow Wifi. Default: true |
| allow_manual_wifi_config | boolean | Optional | Allow Manual Wifi Config. Default: true |
| allow_wifi_hotspot | boolean | Optional | Allow Wifi Hotspot. Default: true |
| allow_auto_wifi_hotspot | boolean | Optional | Allow Auto Wifi Hotspot. Default: true |
| allow_internet_sharing | boolean | Optional | Allow Internet Sharing. Default: true |
| allow_vpn | boolean | Optional | Allow Vpn. Default: true |
| allow_vpn_roaming | boolean | Optional | Allow Vpn Roaming. Default: true |
| allow_vpn_over_data | string | Optional | Allow Vpn Over Data. Default: userConfig |
| allow_vpn_over_data_roaming | string | Optional | Allow Vpn Over Data Roaming. Default: userConfig |
| allow_data_roaming | boolean | Optional | Allow Data Roaming. Default: true |
| allow_copy_paste | boolean | Optional | Allow Copy Paste. Default: true |
| allow_location | integer | Optional | Allow Location. Default: true |
| allow_microsoft_account | boolean | Optional | Allow Microsoft Account. Default: true |
| allow_adding_non_microsoft | boolean | Optional | Allow Adding Non Microsoft. Default: true |
| allow_root_certificate_install | boolean | Optional | Allow Root Certificate Install. Default: true |
| allow_developer_unlock | boolean | Optional | Allow Developer Unlock. Default: true |
| allow_developer_unlock_new | string | Optional | Allow Developer Unlock New. Default: userConfig |
| allow_user_reset_phone | boolean | Optional | Allow User Reset Phone. Default: true |
| allow_action_notification | boolean | Optional | Allow Action Notification. Default: true |
| allow_cortana | boolean | Optional | Allow Cortana. Default: true |
| allow_voice_recording | boolean | Optional | Allow Voice Recording. Default: true |
| allow_save_as_office_files | boolean | Optional | Allow Save As Office Files. Default: true |
| allow_sharing_office_files | boolean | Optional | Allow Sharing Office Files. Default: true |
| allow_sync_my_settings | boolean | Optional | Allow Sync My Settings. Default: true |
| allow_search_use_location | boolean | Optional | Allow Search Use Location. Default: true |
| safe_search_permissions | integer | Optional | Safe Search Permissions. Default: -1 |
| allow_storing_image_search | boolean | Optional | Allow Storing Image Search. Default: true |
| allow_toast | boolean | Optional | Allow Toast. Default: true |
| limit_appdata_to_sys_vol | boolean | Optional | Limit Appdata To Sys Vol. Default: false |
| limit_appinstall_to_sys_vol | boolean | Optional | Limit Appinstall To Sys Vol. Default: false |
| allow_all_trusted_apps | integer | Optional | Allow All Trusted Apps. Default: 65535 |
| allow_appstore_auto_update | integer | Optional | Allow Appstore Auto Update. Default: -999 |
| require_private_store_only | boolean | Optional | Require Private Store Only. Default: false |
| allow_bluetooth_advertising | boolean | Optional | Allow Bluetooth Advertising. Default: true |
| allow_bluetooth_discoverable | boolean | Optional | Allow Bluetooth Discoverable. Default: true |
| allow_bluetooth_prepairing | boolean | Optional | Allow Bluetooth Prepairing. Default: true |
| browser_allow_cookies | string | Optional | Browser Allow Cookies. Default: userConfig |
| browser_allow_donot_track | string | Optional | Browser Allow Donot Track. Default: userConfig |
| browser_allow_extensions | boolean | Optional | Browser Allow Extensions. Default: true |
| browser_clear_browsing_data_exit | integer | Optional | Browser Clear Browsing Data Exit. Default: -999 |
| browser_about_flags_access | boolean | Optional | Browser About Flags Access. Default: true |
| browser_allow_address_bar_dropdown | boolean | Optional | Browser Allow Address Bar Dropdown. Default: true |
| browser_allow_flash | integer | Optional | Browser Allow Flash. Default: -999 |
| browser_run_flash_automatically | boolean | Optional | Browser Run Flash Automatically. Default: false |
| browser_allow_autofill | integer | Optional | Browser Allow Autofill. Default: -999 |
| browser_allow_popups | integer | Optional | Browser Allow Popups. Default: -999 |
| browser_allow_developer_tools | boolean | Optional | Browser Allow Developer Tools. Default: true |
| browser_home_page | string | Optional | Browser Home Page |
| browser_allow_inprivate | boolean | Optional | Browser Allow Inprivate. Default: true |
| browser_allow_passmgr | string | Optional | Browser Allow Passmgr. Default: userConfig |
| browser_allow_searchsuggest | string | Optional | Browser Allow Searchsuggest. Default: userConfig |
| browser_allow_smartscreen | string | Optional | Browser Allow Smartscreen. Default: userConfig |
| browser_smartscreen_prompt | string | Optional | Browser Smartscreen Prompt. Default: userConfig |
| browser_smartscreen_files | string | Optional | Browser Smartscreen Files. Default: userConfig |
| allow_cellular_data | integer | Optional | Allow Cellular Data. Default: 1 |
| allow_vpn_setting | boolean | Optional | Allow Vpn Setting. Default: true |
| allow_fips_policy | boolean | Optional | Allow Fips Policy. Default: false |
| ms_feedback_notif | integer | Optional | Ms Feedback Notif. Default: 0 |
| allow_add_prov_package | boolean | Optional | Allow Add Prov Package. Default: true |
| allow_remove_prov_package | boolean | Optional | Allow Remove Prov Package. Default: true |
| enable_anti_theft_mode | integer | Optional | Enable Anti Theft Mode. Default: 1 |
| allow_date_time | boolean | Optional | Allow Date Time. Default: true |
| allow_edit_device_name | boolean | Optional | Allow Edit Device Name. Default: true |

## Sample Request

```curl
curl --request POST \
  --url https://appdomain/api/v1/mdm/profiles/{profile_id}/payloads/windowsrestrictionpolicy \
  --header 'Accept: application/json' \
  --header 'Authorization:  d92d4xxxxxxxxxxxxx15f52' \
  --header 'Content-Type: application/json' \
  --data '{"allow_sharing_office_files":true,"allow_nfc":true,"allow_vpn_over_data":"userConfig","allow_all_trusted_apps":"65535","allow_bluetooth_discoverable":true,"allow_action_notification":true,"allow_appstore_auto_update":"-999","allow_developer_unlock":true,"allow_bluetooth_advertising":true,"disable_sd_card":false,"allow_screen_capture":true,"allow_microsoft_account":true,"allow_cellular_data":"1","allow_use_of_camera":true,"allow_data_roaming":true,"safe_search_permissions":"-1","allow_user_reset_phone":true,"allow_location":"1","allow_vpn_roaming":true,"allow_search_use_location":true,"allow_store":true,"allow_sync_my_settings":true,"allow_save_as_office_files":true,"allow_usb":true,"allow_fips_policy":false,"allow_storage_card":true,"allow_adding_non_microsoft":true,"allow_wifi":true,"allow_internet_sharing":true,"allow_cortana":true,"allow_voice_recording":true,"limit_appdata_to_sys_vol":false,"enforce_device_encription":false,"allow_vpn":true,"allow_root_certificate_install":true,"allow_bluetooth":true,"ms_feedback_notif":"0","allow_telemetry":"2","allow_vpn_setting":true,"require_private_store_only":false,"allow_add_prov_package":true,"limit_appinstall_to_sys_vol":false,"allow_developer_unlock_new":"userConfig","allow_vpn_over_data_roaming":"userConfig","allow_remove_prov_package":true,"allow_edit_device_name":true,"allow_toast":true,"allow_storing_image_search":true,"enable_anti_theft_mode":"1","allow_auto_wifi_hotspot":true,"allow_date_time":true,"allow_manual_wifi_config":false,"allow_copy_paste":true,"allow_wifi_hotspot":true,"allow_bluetooth_prepairing":true}'
```

## Sample Request Body

Add Restrictions payload to the profile

```json
{
  "allow_sharing_office_files": true,
  "allow_nfc": true,
  "allow_vpn_over_data": "userConfig",
  "allow_all_trusted_apps": "65535",
  "allow_bluetooth_discoverable": true,
  "allow_action_notification": true,
  "allow_appstore_auto_update": "-999",
  "allow_developer_unlock": true,
  "allow_bluetooth_advertising": true,
  "disable_sd_card": false,
  "allow_screen_capture": true,
  "allow_microsoft_account": true,
  "allow_cellular_data": "1",
  "allow_use_of_camera": true,
  "allow_data_roaming": true,
  "safe_search_permissions": "-1",
  "allow_user_reset_phone": true,
  "allow_location": "1",
  "allow_vpn_roaming": true,
  "allow_search_use_location": true,
  "allow_store": true,
  "allow_sync_my_settings": true,
  "allow_save_as_office_files": true,
  "allow_usb": true,
  "allow_fips_policy": false,
  "allow_storage_card": true,
  "allow_adding_non_microsoft": true,
  "allow_wifi": true,
  "allow_internet_sharing": true,
  "allow_cortana": true,
  "allow_voice_recording": true,
  "limit_appdata_to_sys_vol": false,
  "enforce_device_encription": false,
  "allow_vpn": true,
  "allow_root_certificate_install": true,
  "allow_bluetooth": true,
  "ms_feedback_notif": "0",
  "allow_telemetry": "2",
  "allow_vpn_setting": true,
  "require_private_store_only": false,
  "allow_add_prov_package": true,
  "limit_appinstall_to_sys_vol": false,
  "allow_developer_unlock_new": "userConfig",
  "allow_vpn_over_data_roaming": "userConfig",
  "allow_remove_prov_package": true,
  "allow_edit_device_name": true,
  "allow_toast": true,
  "allow_storing_image_search": true,
  "enable_anti_theft_mode": "1",
  "allow_auto_wifi_hotspot": true,
  "allow_date_time": true,
  "allow_manual_wifi_config": false,
  "allow_copy_paste": true,
  "allow_wifi_hotspot": true,
  "allow_bluetooth_prepairing": true
}
```

## Response Parameters

### HTTP Code 200

Response Body: `application/json`

| Attribute | Type | Description |
|---|---|---|
| payload_id | long | Unique identifier for the created payload item |
| enforce_device_encription | boolean | Enforce Device Encription. Default: false |
| disable_sd_card | boolean | Disable Sd Card. Default: false |
| allow_use_of_camera | boolean | Allow Use Of Camera. Default: true |
| allow_screen_capture | boolean | Allow Screen Capture. Default: true |
| allow_store | boolean | Allow Store. Default: true |
| allow_storage_card | boolean | Allow Storage Card. Default: true |
| allow_browser | boolean | Allow Browser. Default: true |
| allow_bluetooth | boolean | Allow Bluetooth. Default: true |
| allow_telemetry | integer | Allow Telemetry. Default: 2 |
| allow_nfc | boolean | Allow Nfc. Default: true |
| allow_usb | boolean | Allow Usb. Default: true |
| allow_wifi | boolean | Allow Wifi. Default: true |
| allow_manual_wifi_config | boolean | Allow Manual Wifi Config. Default: true |
| allow_wifi_hotspot | boolean | Allow Wifi Hotspot. Default: true |
| allow_auto_wifi_hotspot | boolean | Allow Auto Wifi Hotspot. Default: true |
| allow_internet_sharing | boolean | Allow Internet Sharing. Default: true |
| allow_vpn | boolean | Allow Vpn. Default: true |
| allow_vpn_roaming | boolean | Allow Vpn Roaming. Default: true |
| allow_vpn_over_data | string | Allow Vpn Over Data. Default: userConfig |
| allow_vpn_over_data_roaming | string | Allow Vpn Over Data Roaming. Default: userConfig |
| allow_data_roaming | boolean | Allow Data Roaming. Default: true |
| allow_copy_paste | boolean | Allow Copy Paste. Default: true |
| allow_location | integer | Allow Location. Default: true |
| allow_microsoft_account | boolean | Allow Microsoft Account. Default: true |
| allow_adding_non_microsoft | boolean | Allow Adding Non Microsoft. Default: true |
| allow_root_certificate_install | boolean | Allow Root Certificate Install. Default: true |
| allow_developer_unlock | boolean | Allow Developer Unlock. Default: true |
| allow_developer_unlock_new | string | Allow Developer Unlock New. Default: userConfig |
| allow_user_reset_phone | boolean | Allow User Reset Phone. Default: true |
| allow_action_notification | boolean | Allow Action Notification. Default: true |
| allow_cortana | boolean | Allow Cortana. Default: true |
| allow_voice_recording | boolean | Allow Voice Recording. Default: true |
| allow_save_as_office_files | boolean | Allow Save As Office Files. Default: true |
| allow_sharing_office_files | boolean | Allow Sharing Office Files. Default: true |
| allow_sync_my_settings | boolean | Allow Sync My Settings. Default: true |
| allow_search_use_location | boolean | Allow Search Use Location. Default: true |
| safe_search_permissions | integer | Safe Search Permissions. Default: -1 |
| allow_storing_image_search | boolean | Allow Storing Image Search. Default: true |
| allow_toast | boolean | Allow Toast. Default: true |
| limit_appdata_to_sys_vol | boolean | Limit Appdata To Sys Vol. Default: false |
| limit_appinstall_to_sys_vol | boolean | Limit Appinstall To Sys Vol. Default: false |
| allow_all_trusted_apps | integer | Allow All Trusted Apps. Default: 65535 |
| allow_appstore_auto_update | integer | Allow Appstore Auto Update. Default: -999 |
| require_private_store_only | boolean | Require Private Store Only. Default: false |
| allow_bluetooth_advertising | boolean | Allow Bluetooth Advertising. Default: true |
| allow_bluetooth_discoverable | boolean | Allow Bluetooth Discoverable. Default: true |
| allow_bluetooth_prepairing | boolean | Allow Bluetooth Prepairing. Default: true |
| browser_allow_cookies | string | Browser Allow Cookies. Default: userConfig |
| browser_allow_donot_track | string | Browser Allow Donot Track. Default: userConfig |
| browser_allow_extensions | boolean | Browser Allow Extensions. Default: true |
| browser_clear_browsing_data_exit | integer | Browser Clear Browsing Data Exit. Default: -999 |
| browser_about_flags_access | boolean | Browser About Flags Access. Default: true |
| browser_allow_address_bar_dropdown | boolean | Browser Allow Address Bar Dropdown. Default: true |
| browser_allow_flash | integer | Browser Allow Flash. Default: -999 |
| browser_run_flash_automatically | boolean | Browser Run Flash Automatically. Default: false |
| browser_allow_autofill | integer | Browser Allow Autofill. Default: -999 |
| browser_allow_popups | integer | Browser Allow Popups. Default: -999 |
| browser_allow_developer_tools | boolean | Browser Allow Developer Tools. Default: true |
| browser_home_page | string | Browser Home Page |
| browser_allow_inprivate | boolean | Browser Allow Inprivate. Default: true |
| browser_allow_passmgr | string | Browser Allow Passmgr. Default: userConfig |
| browser_allow_searchsuggest | string | Browser Allow Searchsuggest. Default: userConfig |
| browser_allow_smartscreen | string | Browser Allow Smartscreen. Default: userConfig |
| browser_smartscreen_prompt | string | Browser Smartscreen Prompt. Default: userConfig |
| browser_smartscreen_files | string | Browser Smartscreen Files. Default: userConfig |
| allow_cellular_data | integer | Allow Cellular Data. Default: 1 |
| allow_vpn_setting | boolean | Allow Vpn Setting. Default: true |
| allow_fips_policy | boolean | Allow Fips Policy. Default: false |
| ms_feedback_notif | integer | Ms Feedback Notif. Default: 0 |
| allow_add_prov_package | boolean | Allow Add Prov Package. Default: true |
| allow_remove_prov_package | boolean | Allow Remove Prov Package. Default: true |
| enable_anti_theft_mode | integer | Enable Anti Theft Mode. Default: 1 |
| allow_date_time | boolean | Allow Date Time. Default: true |
| allow_edit_device_name | boolean | Allow Edit Device Name. Default: true |

### Possible Response Codes

| Code | Type |
|---|---|
| 200 | HTTP code |

## Sample Response: HTTP 200

Restrictions payload successfully added

```json
{
  "allow_sharing_office_files": true,
  "browser_allow_extensions": true,
  "allow_nfc": true,
  "allow_vpn_over_data": "userConfig",
  "browser_allow_autofill": "-999",
  "allow_all_trusted_apps": "65535",
  "allow_bluetooth_discoverable": true,
  "allow_action_notification": true,
  "allow_appstore_auto_update": "-999",
  "allow_developer_unlock": true,
  "allow_bluetooth_advertising": true,
  "disable_sd_card": false,
  "allow_screen_capture": true,
  "browser_allow_developer_tools": true,
  "allow_microsoft_account": true,
  "allow_cellular_data": "1",
  "allow_use_of_camera": true,
  "browser_allow_address_bar_dropdown": true,
  "browser_home_page": "",
  "allow_data_roaming": true,
  "safe_search_permissions": "-1",
  "allow_user_reset_phone": true,
  "allow_location": "1",
  "allow_vpn_roaming": true,
  "browser_allow_inprivate": true,
  "browser_allow_popups": "-999",
  "allow_search_use_location": true,
  "allow_store": true,
  "allow_sync_my_settings": true,
  "allow_save_as_office_files": true,
  "allow_usb": true,
  "allow_fips_policy": false,
  "allow_storage_card": true,
  "allow_adding_non_microsoft": true,
  "browser_smartscreen_prompt": "userConfig",
  "allow_wifi": true,
  "browser_allow_donot_track": "userConfig",
  "allow_internet_sharing": true,
  "allow_cortana": true,
  "allow_voice_recording": true,
  "limit_appdata_to_sys_vol": false,
  "browser_clear_browsing_data_exit": "-999",
  "enforce_device_encription": false,
  "allow_vpn": true,
  "allow_root_certificate_install": true,
  "allow_bluetooth": true,
  "ms_feedback_notif": "0",
  "allow_telemetry": "2",
  "allow_vpn_setting": true,
  "require_private_store_only": false,
  "browser_allow_passmgr": "userConfig",
  "allow_add_prov_package": true,
  "limit_appinstall_to_sys_vol": false,
  "allow_developer_unlock_new": "userConfig",
  "browser_allow_searchsuggest": "userConfig",
  "payload_id": "9007199254741295",
  "allow_vpn_over_data_roaming": "userConfig",
  "allow_remove_prov_package": true,
  "browser_smartscreen_files": "userConfig",
  "allow_edit_device_name": true,
  "allow_toast": true,
  "allow_storing_image_search": true,
  "enable_anti_theft_mode": "1",
  "browser_allow_flash": "-999",
  "allow_auto_wifi_hotspot": true,
  "allow_date_time": true,
  "allow_manual_wifi_config": false,
  "browser_allow_smartscreen": "userConfig",
  "allow_copy_paste": true,
  "allow_browser": true,
  "browser_allow_cookies": "userConfig",
  "browser_run_flash_automatically": false,
  "browser_about_flags_access": true,
  "allow_wifi_hotspot": true,
  "allow_bluetooth_prepairing": true
}
```

![ ](https://www.zohowebstatic.com/sites/zweb/images/people/ico-help.png)

**Duration:** 1 minute | **Threshold:** 30 | **Lock period:** 5 minutes

Duration - Time window for the threshold.  
Threshold - Number of API calls allowed within the specified duration.  
Lock Period - Wait time before consecutive API requests.