Modify the configuration of a Restrictions payload item within a profile

To modify Mac Restrictions policy payload item

Endpoints

put /api/v1/mdm/profiles/{profile_id}/payloads/macrestrictionspolicy/payloaditems/{payload_id}

Copy full URL

Request URL

https://{server-hostname}:8383/api/v1/mdm/profiles/{profile_id}/payloads/macrestrictionspolicy/payloaditems/{payload_id}

Scope

MDMDeviceMgmt.UPDATECopied!

Header

Authorization: d92d4xxxxxxxxxxxxx15f52

Request Parameters

- Request Headers

Content-TypestringMandatory

application/jsonCopied!

AcceptstringMandatory

application/jsonCopied!

- Path Parameters

profile_idstringMandatory

Unique identifier of the profile. Obtain from the Create Profile or Get Profiles response

payload_idstringMandatory

Unique identifier of the payload item. Obtain from the Get Payload Item IDs response

- Request Body

application/json

JSON Object

Hide Sub-Attributes

allow_game_centerbooleanOptional

Allow Game Center. Default: true

allow_modifi_wallpaperbooleanOptional

Allow Modifi Wallpaper. Default: true

allow_use_of_camerabooleanOptional

Allow Use Of Camera. Default: true

allow_cloud_document_syncbooleanOptional

Allow Cloud Document Sync. Default: true

allow_cloud_keychain_syncbooleanOptional

Allow Cloud Keychain Sync. Default: true

allow_touch_idbooleanOptional

Allow Touch Id. Default: true

safari_allow_autofillbooleanOptional

Safari Allow Autofill. Default: true

allow_spotlight_resultbooleanOptional

Allow Spotlight Result. Default: true

force_assist_profanity_filterbooleanOptional

Force Assist Profanity Filter. Default: false

allow_activity_continuationbooleanOptional

Allow Activity Continuation. Default: true

allow_dictionary_lookupbooleanOptional

Allow Dictionary Lookup. Default: true

allow_music_servicebooleanOptional

Allow Music Service. Default: true

allow_screen_capturebooleanOptional

Allow Screen Capture. Default: true

allow_classroom_remoteviewbooleanOptional

Allow Classroom Remoteview. Default: true

force_classroom_auto_joinbooleanOptional

Force Classroom Auto Join. Default: false

force_classroom_appdevicelockbooleanOptional

Force Classroom Appdevicelock. Default: false

force_classroom_remoteviewbooleanOptional

Force Classroom Remoteview. Default: false

allow_password_autofillbooleanOptional

Allow Password Autofill. Default: true

allow_password_proximitybooleanOptional

Allow Password Proximity. Default: true

allow_password_sharingbooleanOptional

Allow Password Sharing. Default: true

allow_cloud_photo_libbooleanOptional

Allow Cloud Photo Lib. Default: true

request_to_leave_classroombooleanOptional

Request To Leave Classroom. Default: false

allow_content_cachingbooleanOptional

Allow Content Caching. Default: true

allow_itunes_file_sharingbooleanOptional

Allow Itunes File Sharing. Default: true

allow_auto_unlockbooleanOptional

Allow Auto Unlock. Default: true

allow_cloud_desktop_documentbooleanOptional

Allow Cloud Desktop Document. Default: true

allow_cloud_bookmarksbooleanOptional

Allow Cloud Bookmarks. Default: true

allow_cloud_mailbooleanOptional

Allow Cloud Mail. Default: true

allow_cloud_calenderbooleanOptional

Allow Cloud Calender. Default: true

allow_cloud_remindersbooleanOptional

Allow Cloud Reminders. Default: true

allow_cloud_addressbookbooleanOptional

Allow Cloud Addressbook. Default: true

allow_cloud_notesbooleanOptional

Allow Cloud Notes. Default: true

gatekeeper_settingintegerOptional

Gatekeeper app source restriction. Allowed values: 1=App Store Only, 2=App Store and Identified Developers, 3=Anywhere, 4=Not Configured. Default: 3

allow_override_gatekeeperbooleanOptional

Allow Override Gatekeeper. Default: false

allow_dictationbooleanOptional

Allow Dictation. Default: true

allow_assistantbooleanOptional

Allow Assistant. Default: true

allow_use_of_ibookstorebooleanOptional

Allow Use Of Ibookstore. Default: true

allow_ibookstore_erotica_mediabooleanOptional

Allow Ibookstore Erotica Media. Default: true

movies_rating_valueintegerOptional

Movie content rating filter. Allowed values vary by country. US values: 0=Don't Allow, 100=G, 200=PG, 300=PG-13, 400=R, 500=NC-17, 1000=Allow All Movies. Default: 1000

tv_shows_rating_valueintegerOptional

TV show content rating filter. Allowed values vary by country. US values: 0=Don't Allow, 100=TV-Y, 200=TV-Y7, 300=TV-G, 400=TV-PG, 500=TV-14, 600=TV-MA, 1000=Allow All TV Shows. Default: 1000

apps_rating_valueintegerOptional

App Store content rating filter. Allowed values vary by country. US values: 0=Don't Allow, 100=4+, 200=9+, 300=12+, 600=17+, 1000=Allow All Apps. Default: 1000

allow_find_my_friendbooleanOptional

Allow Find My Friend. Default: true

allow_find_my_devicebooleanOptional

Allow Find My Device. Default: true

allow_erase_content_settingsbooleanOptional

Allow Erase Content Settings. Default: true

is_rating_enabledbooleanOptional

Is Rating Enabled. Default: false

country_codestringOptional

Country Code. Default: us

allow_cloud_private_relaybooleanOptional

Allow Cloud Private Relay. Default: true

allow_usb_restriction_modebooleanOptional

Allow Usb Restriction Mode. Default: true

allow_universal_controlbooleanOptional

Allow Universal Control. Default: true

allow_profile_installationbooleanOptional

Allow Profile Installation. Default: true

allow_rapid_security_response_installationbooleanOptional

Allow Rapid Security Response Installation. Default: true

allow_rapid_security_response_removalbooleanOptional

Allow Rapid Security Response Removal. Default: true

allow_airdropbooleanOptional

Allow Airdrop. Default: true

allow_bluetooth_modificationbooleanOptional

Allow Bluetooth Modification. Default: true

bluetooth_settingintegerOptional

Bluetooth setting. Allowed values: 0=Off, 1=On, 2=Not Configured

allow_marketplace_app_installationbooleanOptional

Allow Marketplace App Installation. Default: true

allow_web_distribution_app_installationbooleanOptional

Allow Web Distribution App Installation. Default: true

allow_modifi_passcodebooleanOptional

Allow Modifi Passcode. Default: true

allow_diagnostic_submissionbooleanOptional

Allow Diagnostic Submission. Default: True

allow_apple_personalized_adsbooleanOptional

Allow Apple Personalized Ads. Default: True

allow_iphone_mirroringbooleanOptional

Allow Iphone Mirroring. Default: True

allow_modifi_device_namebooleanOptional

Allow Modifi Device Name. Default: True

allow_cloud_freeformbooleanOptional

Allow Cloud Freeform. Default: True

enforced_fingerprint_timeoutlongOptional

Enforced Fingerprint Timeout. Default: 172800

allow_modify_touch_idbooleanOptional

Allow Modify Touch Id. Default: True

allow_printer_sharing_modificationbooleanOptional

Allow Printer Sharing Modification. Default: True

allow_file_sharing_modificationbooleanOptional

Allow File Sharing Modification. Default: True

allow_internet_sharing_modificationbooleanOptional

Allow Internet Sharing Modification. Default: True

allow_bluetooth_sharing_modificationbooleanOptional

Allow Bluetooth Sharing Modification. Default: True

allow_time_machine_backupbooleanOptional

Allow Time Machine Backup. Default: True

allow_multiplayer_gamingbooleanOptional

Allow Multiplayer Gaming. Default: True

allow_local_user_creationbooleanOptional

Allow Local User Creation. Default: True

airplay_incoming_requestbooleanOptional

Airplay Incoming Request. Default: True

allow_account_modificationbooleanOptional

Allow Account Modification. Default: True

allow_ard_remote_management_modificationbooleanOptional

Allow Ard Remote Management Modification. Default: True

allow_startup_disk_modificationbooleanOptional

Allow Startup Disk Modification. Default: True

allow_remote_apple_events_modificationbooleanOptional

Allow Remote Apple Events Modification. Default: True

allow_image_playgroundbooleanOptional

Allow Image Playground. Default: True

allow_writing_toolsbooleanOptional

Allow Writing Tools. Default: True

allow_external_intelligence_integrationsbooleanOptional

Allow External Intelligence Integrations. Default: True

force_delayed_software_updatesbooleanOptional

Force Delayed Software Updates. Default: False

force_delayed_app_software_updatesbooleanOptional

Force Delayed App Software Updates. Default: False

force_delayed_major_software_updatesbooleanOptional

Force Delayed Major Software Updates. Default: False

software_update_delaylongOptional

Software Update Delay. Default: 30

software_update_minor_os_deferred_install_delaylongOptional

Software Update Minor Os Deferred Install Delay. Default: 30

software_update_major_os_deferred_install_delaylongOptional

Software Update Major Os Deferred Install Delay. Default: 30

software_update_non_os_deferred_install_delaylongOptional

Software Update Non Os Deferred Install Delay. Default: 30

allow_external_intelligence_integrations_signinbooleanOptional

Allow External Intelligence Integrations Signin. Default: True

allow_mail_summarybooleanOptional

Allow Mail Summary. Default: True

allow_notes_transcription_summarybooleanOptional

Allow Notes Transcription Summary. Default: True

allow_external_intelligence_workspace_idsstringOptional

Allow External Intelligence Workspace Ids

force_bypass_screen_capture_alertbooleanOptional

Force Bypass Screen Capture Alert. Default: False

allow_media_sharing_modificationbooleanOptional

Allow Media Sharing Modification. Default: False

allow_apple_intelligence_reportbooleanOptional

Allow Apple Intelligence Report. Default: True

allow_mail_smart_repliesbooleanOptional

Allow Mail Smart Replies. Default: True

allow_safari_summarybooleanOptional

Allow Safari Summary. Default: True

allow_safari_private_browsingbooleanOptional

Allow Safari Private Browsing. Default: True

allow_safari_history_clearingbooleanOptional

Allow Safari History Clearing. Default: True

allow_add_game_center_friendbooleanOptional

Allow adding Game Center friends. Default: true

allow_airprintbooleanOptional

Allow AirPrint. Default: true

allow_airprint_credential_storagebooleanOptional

Allow AirPrint credential storage. Default: true

allow_airprint_ibeacon_discoverybooleanOptional

Allow AirPrint iBeacon discovery. Default: true

allow_app_cellular_databooleanOptional

Allow app cellular data modification. Default: true

allow_app_installationbooleanOptional

Allow app installation. Default: true

allow_app_removalbooleanOptional

Allow app removal. Default: true

allow_assistant_user_contentbooleanOptional

Allow Siri user-generated content. Default: true

allow_assistant_when_lockedbooleanOptional

Allow Siri when locked. Default: true

allow_auto_app_downloadbooleanOptional

Allow automatic app downloads. Default: true

allow_auto_correctionbooleanOptional

Allow auto-correction. Default: true

allow_cloud_backupbooleanOptional

Allow iCloud backup. Default: true

allow_diag_sub_modificationbooleanOptional

Allow diagnostics submission modification. Default: true

allow_enabling_restrictionbooleanOptional

Allow enabling restrictions. Default: true

allow_esim_modificationbooleanOptional

Allow eSIM modification. Default: true

allow_explicit_contentbooleanOptional

Allow explicit content. Default: true

allow_face_timebooleanOptional

Allow FaceTime. Default: true

allow_find_my_friends_modbooleanOptional

Allow Find My Friends modification. Default: true

allow_host_pairingbooleanOptional

Allow host pairing. Default: true

allow_hotspot_modificationbooleanOptional

Allow hotspot modification. Default: true

allow_imessagebooleanOptional

Allow iMessage. Default: true

allow_inapp_purchasebooleanOptional

Allow in-app purchase. Default: true

allow_itunesbooleanOptional

Allow iTunes. Default: true

allow_keyboard_shortcutbooleanOptional

Allow keyboard shortcuts. Default: true

allow_managed_app_cloud_syncbooleanOptional

Allow managed app cloud sync. Default: true

allow_managed_app_trustbooleanOptional

Allow trusting managed app developers. Default: true

allow_managed_book_backupbooleanOptional

Allow managed book backup. Default: true

allow_managed_book_syncbooleanOptional

Allow managed book sync. Default: true

allow_managed_write_unmanaged_contactbooleanOptional

Allow managed apps to write to unmanaged contacts. Default: true

allow_newsbooleanOptional

Allow News. Default: true

allow_open_doc_in_managedbooleanOptional

Allow opening documents in managed apps. Default: true

allow_open_doc_in_unmanagedbooleanOptional

Allow opening documents in unmanaged apps. Default: true

allow_ota_pki_updatesbooleanOptional

Allow OTA PKI updates. Default: true

allow_paired_watchbooleanOptional

Allow paired Apple Watch. Default: true

allow_passbook_when_lockedbooleanOptional

Allow Wallet when locked. Default: true

allow_photo_streambooleanOptional

Allow Photo Stream. Default: true

allow_podcastsbooleanOptional

Allow Podcasts. Default: true

allow_predictive_keyboardbooleanOptional

Allow predictive keyboard. Default: true

allow_proximity_for_newdevicebooleanOptional

Allow proximity setup for new devices. Default: true

allow_radio_servicebooleanOptional

Allow Radio Service. Default: true

allow_safaribooleanOptional

Allow Safari. Default: true

allow_shared_streambooleanOptional

Allow shared Photo Stream. Default: true

allow_siri_loggingbooleanOptional

Allow Siri server logging. Default: true

allow_spellcheckbooleanOptional

Allow spellcheck. Default: true

allow_sync_while_roamingbooleanOptional

Allow sync while roaming. Default: true

allow_unmanaged_read_managed_contactbooleanOptional

Allow unmanaged apps to read managed contacts. Default: true

allow_untrusted_tls_promptbooleanOptional

Allow untrusted TLS prompt. Default: true

allow_use_of_youtubebooleanOptional

Allow use of YouTube. Default: true

allow_voice_dialingbooleanOptional

Allow voice dialing. Default: true

allow_vpn_creationbooleanOptional

Allow VPN creation. Default: true

allowCloudAddressBookbooleanOptional

Allow iCloud Address Book sync. Default: true

authenticate_before_autofillbooleanOptional

Require authentication before autofill. Default: false

force_airdrop_unmanagedbooleanOptional

Treat AirDrop as unmanaged destination. Default: false

force_airplay_incoming_pwdbooleanOptional

Force password for incoming AirPlay requests. Default: false

force_airplay_outgoing_pwdbooleanOptional

Force password for outgoing AirPlay requests. Default: false

force_airprint_tlsbooleanOptional

Force AirPrint to use TLS. Default: false

force_date_timebooleanOptional

Force automatic date and time. Default: false

force_encrypted_backupbooleanOptional

Force encrypted backup. Default: false

force_istore_pwd_entrybooleanOptional

Force iTunes Store password entry. Default: false

force_limited_ad_trackingbooleanOptional

Force limited ad tracking. Default: false

force_watch_wrist_detectbooleanOptional

Force Apple Watch wrist detection. Default: false

force_wifi_whitelistingbooleanOptional

Force WiFi whitelisting. Default: false

safari_allow_javascriptbooleanOptional

Safari allow JavaScript. Default: true

safari_allow_popupsbooleanOptional

Safari allow pop-ups. Default: true

safari_force_fraud_warningbooleanOptional

Safari force fraud warning. Default: true

show_control_centerbooleanOptional

Show Control Center on lock screen. Default: true

show_notification_centerbooleanOptional

Show Notification Center on lock screen. Default: true

show_today_viewbooleanOptional

Show Today View on lock screen. Default: true

hotspot_settingintegerOptional

Personal hotspot setting. Allowed values: 0=Disable, 1=Enable

safari_accept_cookiesintegerOptional

Safari cookie acceptance policy. Allowed values: 0=Always, 1=Never, 1.5=From visited sites, 2=From current website only

Sample Request

Curl

Java

Python

Deluge

PowerShell

Copied!

curl --request PUT \
  --url https://appdomain/api/v1/mdm/profiles/{profile_id}/payloads/macrestrictionspolicy/payloaditems/{payload_id} \
  --header 'Accept: application/json' \
  --header 'Authorization:  d92d4xxxxxxxxxxxxx15f52' \
  --header 'Content-Type: application/json' \
  --data '{"allow_activity_continuation":true,"safari_allow_autofill":true,"force_assist_profanity_filter":false,"allow_cloud_document_sync":true,"allow_game_center":true,"allow_use_of_camera":true,"allow_touch_id":true,"allow_modifi_wallpaper":true,"allow_spotlight_result":true,"allow_cloud_keychain_sync":true}'

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.io.IOException;
import java.net.http.HttpTimeoutException;

public class Main {
  public static void main(String[] args) {

    HttpRequest request = HttpRequest.newBuilder()
        .uri(URI.create("https://appdomain/api/v1/mdm/profiles/{profile_id}/payloads/macrestrictionspolicy/payloaditems/{payload_id}"))
        .header("Content-Type", "application/json")
        .header("Accept", "application/json")
        .header("Authorization", " d92d4xxxxxxxxxxxxx15f52")
        .method("PUT", HttpRequest.BodyPublishers.ofString("{\"allow_activity_continuation\":true,\"safari_allow_autofill\":true,\"force_assist_profanity_filter\":false,\"allow_cloud_document_sync\":true,\"allow_game_center\":true,\"allow_use_of_camera\":true,\"allow_touch_id\":true,\"allow_modifi_wallpaper\":true,\"allow_spotlight_result\":true,\"allow_cloud_keychain_sync\":true}"))
        .build();
    HttpResponse response = HttpClient.newHttpClient().send(request, HttpResponse.BodyHandlers.ofString());
    System.out.println(response.body());
  
  }
}

import http.client

conn = http.client.HTTPSConnection("appdomain")

payload = "{\"allow_activity_continuation\":true,\"safari_allow_autofill\":true,\"force_assist_profanity_filter\":false,\"allow_cloud_document_sync\":true,\"allow_game_center\":true,\"allow_use_of_camera\":true,\"allow_touch_id\":true,\"allow_modifi_wallpaper\":true,\"allow_spotlight_result\":true,\"allow_cloud_keychain_sync\":true}"

headers = {
    'Content-Type': "application/json",
    'Accept': "application/json",
    'Authorization': " d92d4xxxxxxxxxxxxx15f52"
    }

conn.request("PUT", "/api/v1/mdm/profiles/{profile_id}/payloads/macrestrictionspolicy/payloaditems/{payload_id}", payload, headers)

res = conn.getresponse()
data = res.read()

print(data.decode("utf-8"))


    headersMap = Map();
    headersMap.put("Content-Type", "application/json");
    headersMap.put("Accept", "application/json");

    data=Map();
    data.put("allow_game_center",true);
    data.put("allow_modifi_wallpaper",true);
    data.put("allow_use_of_camera",true);
    data.put("allow_cloud_document_sync",true);
    data.put("allow_cloud_keychain_sync",true);
    data.put("allow_touch_id",true);
    data.put("safari_allow_autofill",true);
    data.put("allow_spotlight_result",true);
    data.put("force_assist_profanity_filter",true);
    data.put("allow_activity_continuation",true);
    data.put("allow_dictionary_lookup",true);
    data.put("allow_music_service",true);
    data.put("allow_screen_capture",true);
    data.put("allow_classroom_remoteview",true);
    data.put("force_classroom_auto_join",true);
    data.put("force_classroom_appdevicelock",true);
    data.put("force_classroom_remoteview",true);
    data.put("allow_password_autofill",true);
    data.put("allow_password_proximity",true);
    data.put("allow_password_sharing",true);
    data.put("allow_cloud_photo_lib",true);
    data.put("request_to_leave_classroom",true);
    data.put("allow_content_caching",true);
    data.put("allow_itunes_file_sharing",true);
    data.put("allow_auto_unlock",true);
    data.put("allow_cloud_desktop_document",true);
    data.put("allow_cloud_bookmarks",true);
    data.put("allow_cloud_mail",true);
    data.put("allow_cloud_calender",true);
    data.put("allow_cloud_reminders",true);
    data.put("allow_cloud_addressbook",true);
    data.put("allow_cloud_notes",true);
    data.put("gatekeeper_setting","1");
    data.put("allow_override_gatekeeper",true);
    data.put("allow_dictation",true);
    data.put("allow_assistant",true);
    data.put("allow_use_of_ibookstore",true);
    data.put("allow_ibookstore_erotica_media",true);
    data.put("movies_rating_value","1");
    data.put("tv_shows_rating_value","1");
    data.put("apps_rating_value","1");
    data.put("allow_find_my_friend",true);
    data.put("allow_find_my_device",true);
    data.put("allow_erase_content_settings",true);
    data.put("is_rating_enabled",true);
    data.put("country_code","value");
    data.put("allow_cloud_private_relay",true);
    data.put("allow_usb_restriction_mode",true);
    data.put("allow_universal_control",true);
    data.put("allow_profile_installation",true);
    data.put("allow_rapid_security_response_installation",true);
    data.put("allow_rapid_security_response_removal",true);
    data.put("allow_airdrop",true);
    data.put("allow_bluetooth_modification",true);
    data.put("bluetooth_setting","1");
    data.put("allow_marketplace_app_installation",true);
    data.put("allow_web_distribution_app_installation",true);
    data.put("allow_modifi_passcode",true);
    data.put("allow_diagnostic_submission",true);
    data.put("allow_apple_personalized_ads",true);
    data.put("allow_iphone_mirroring",true);
    data.put("allow_modifi_device_name",true);
    data.put("allow_cloud_freeform",true);
    data.put("enforced_fingerprint_timeout","1");
    data.put("allow_modify_touch_id",true);
    data.put("allow_printer_sharing_modification",true);
    data.put("allow_file_sharing_modification",true);
    data.put("allow_internet_sharing_modification",true);
    data.put("allow_bluetooth_sharing_modification",true);
    data.put("allow_time_machine_backup",true);
    data.put("allow_multiplayer_gaming",true);
    data.put("allow_local_user_creation",true);
    data.put("airplay_incoming_request",true);
    data.put("allow_account_modification",true);
    data.put("allow_ard_remote_management_modification",true);
    data.put("allow_startup_disk_modification",true);
    data.put("allow_remote_apple_events_modification",true);
    data.put("allow_image_playground",true);
    data.put("allow_writing_tools",true);
    data.put("allow_external_intelligence_integrations",true);
    data.put("force_delayed_software_updates",true);
    data.put("force_delayed_app_software_updates",true);
    data.put("force_delayed_major_software_updates",true);
    data.put("software_update_delay","1");
    data.put("software_update_minor_os_deferred_install_delay","1");
    data.put("software_update_major_os_deferred_install_delay","1");
    data.put("software_update_non_os_deferred_install_delay","1");
    data.put("allow_external_intelligence_integrations_signin",true);
    data.put("allow_mail_summary",true);
    data.put("allow_notes_transcription_summary",true);
    data.put("allow_external_intelligence_workspace_ids","value");
    data.put("force_bypass_screen_capture_alert",true);
    data.put("allow_media_sharing_modification",true);
    data.put("allow_apple_intelligence_report",true);
    data.put("allow_mail_smart_replies",true);
    data.put("allow_safari_summary",true);
    data.put("allow_safari_private_browsing",true);
    data.put("allow_safari_history_clearing",true);
    data.put("allow_add_game_center_friend",true);
    data.put("allow_airprint",true);
    data.put("allow_airprint_credential_storage",true);
    data.put("allow_airprint_ibeacon_discovery",true);
    data.put("allow_app_cellular_data",true);
    data.put("allow_app_installation",true);
    data.put("allow_app_removal",true);
    data.put("allow_assistant_user_content",true);
    data.put("allow_assistant_when_locked",true);
    data.put("allow_auto_app_download",true);
    data.put("allow_auto_correction",true);
    data.put("allow_cloud_backup",true);
    data.put("allow_diag_sub_modification",true);
    data.put("allow_enabling_restriction",true);
    data.put("allow_esim_modification",true);
    data.put("allow_explicit_content",true);
    data.put("allow_face_time",true);
    data.put("allow_find_my_friends_mod",true);
    data.put("allow_host_pairing",true);
    data.put("allow_hotspot_modification",true);
    data.put("allow_imessage",true);
    data.put("allow_inapp_purchase",true);
    data.put("allow_itunes",true);
    data.put("allow_keyboard_shortcut",true);
    data.put("allow_managed_app_cloud_sync",true);
    data.put("allow_managed_app_trust",true);
    data.put("allow_managed_book_backup",true);
    data.put("allow_managed_book_sync",true);
    data.put("allow_managed_write_unmanaged_contact",true);
    data.put("allow_news",true);
    data.put("allow_open_doc_in_managed",true);
    data.put("allow_open_doc_in_unmanaged",true);
    data.put("allow_ota_pki_updates",true);
    data.put("allow_paired_watch",true);
    data.put("allow_passbook_when_locked",true);
    data.put("allow_photo_stream",true);
    data.put("allow_podcasts",true);
    data.put("allow_predictive_keyboard",true);
    data.put("allow_proximity_for_newdevice",true);
    data.put("allow_radio_service",true);
    data.put("allow_safari",true);
    data.put("allow_shared_stream",true);
    data.put("allow_siri_logging",true);
    data.put("allow_spellcheck",true);
    data.put("allow_sync_while_roaming",true);
    data.put("allow_unmanaged_read_managed_contact",true);
    data.put("allow_untrusted_tls_prompt",true);
    data.put("allow_use_of_youtube",true);
    data.put("allow_voice_dialing",true);
    data.put("allow_vpn_creation",true);
    data.put("allowCloudAddressBook",true);
    data.put("authenticate_before_autofill",true);
    data.put("force_airdrop_unmanaged",true);
    data.put("force_airplay_incoming_pwd",true);
    data.put("force_airplay_outgoing_pwd",true);
    data.put("force_airprint_tls",true);
    data.put("force_date_time",true);
    data.put("force_encrypted_backup",true);
    data.put("force_istore_pwd_entry",true);
    data.put("force_limited_ad_tracking",true);
    data.put("force_watch_wrist_detect",true);
    data.put("force_wifi_whitelisting",true);
    data.put("safari_allow_javascript",true);
    data.put("safari_allow_popups",true);
    data.put("safari_force_fraud_warning",true);
    data.put("show_control_center",true);
    data.put("show_notification_center",true);
    data.put("show_today_view",true);
    data.put("hotspot_setting","1");
    data.put("safari_accept_cookies","1");

    response = invokeUrl
    [
        url: "https://appDomain/api/v1/mdm/profiles/{profile_id}/payloads/macrestrictionspolicy/payloaditems/{payload_id}"
        type: PUT
        headers: headersMap
        body: data
        connection: connection_name
    ]

    info response;

$headers=@{}
$headers.Add("Content-Type", "application/json")
$headers.Add("Accept", "application/json")
$headers.Add("Authorization", " d92d4xxxxxxxxxxxxx15f52")
$response = Invoke-WebRequest -Uri 'https://appdomain/api/v1/mdm/profiles/{profile_id}/payloads/macrestrictionspolicy/payloaditems/{payload_id}' -Method PUT -Headers $headers -ContentType 'application/json' -Body '{"allow_activity_continuation":true,"safari_allow_autofill":true,"force_assist_profanity_filter":false,"allow_cloud_document_sync":true,"allow_game_center":true,"allow_use_of_camera":true,"allow_touch_id":true,"allow_modifi_wallpaper":true,"allow_spotlight_result":true,"allow_cloud_keychain_sync":true}'

Sample Request Body

Modify Restrictions payload item

Copied!

  {
    "allow_activity_continuation": true,
    "safari_allow_autofill": true,
    "force_assist_profanity_filter": false,
    "allow_cloud_document_sync": true,
    "allow_game_center": true,
    "allow_use_of_camera": true,
    "allow_touch_id": true,
    "allow_modifi_wallpaper": true,
    "allow_spotlight_result": true,
    "allow_cloud_keychain_sync": true
  }

▼ Show full

Response Parameters

- HTTP code 200

Response Body - application/json

JSON Object

Hide Sub-Attributes

payload_idlong

Unique identifier of the payload item

allow_game_centerboolean

Allow Game Center. Default: true

allow_modifi_wallpaperboolean

Allow Modifi Wallpaper. Default: true

allow_use_of_cameraboolean

Allow Use Of Camera. Default: true

allow_cloud_document_syncboolean

Allow Cloud Document Sync. Default: true

allow_cloud_keychain_syncboolean

Allow Cloud Keychain Sync. Default: true

allow_touch_idboolean

Allow Touch Id. Default: true

safari_allow_autofillboolean

Safari Allow Autofill. Default: true

allow_spotlight_resultboolean

Allow Spotlight Result. Default: true

force_assist_profanity_filterboolean

Force Assist Profanity Filter. Default: false

allow_activity_continuationboolean

Allow Activity Continuation. Default: true

allow_dictionary_lookupboolean

Allow Dictionary Lookup. Default: true

allow_music_serviceboolean

Allow Music Service. Default: true

allow_screen_captureboolean

Allow Screen Capture. Default: true

allow_classroom_remoteviewboolean

Allow Classroom Remoteview. Default: true

force_classroom_auto_joinboolean

Force Classroom Auto Join. Default: false

force_classroom_appdevicelockboolean

Force Classroom Appdevicelock. Default: false

force_classroom_remoteviewboolean

Force Classroom Remoteview. Default: false

allow_password_autofillboolean

Allow Password Autofill. Default: true

allow_password_proximityboolean

Allow Password Proximity. Default: true

allow_password_sharingboolean

Allow Password Sharing. Default: true

allow_cloud_photo_libboolean

Allow Cloud Photo Lib. Default: true

request_to_leave_classroomboolean

Request To Leave Classroom. Default: false

allow_content_cachingboolean

Allow Content Caching. Default: true

allow_itunes_file_sharingboolean

Allow Itunes File Sharing. Default: true

allow_auto_unlockboolean

Allow Auto Unlock. Default: true

allow_cloud_desktop_documentboolean

Allow Cloud Desktop Document. Default: true

allow_cloud_bookmarksboolean

Allow Cloud Bookmarks. Default: true

allow_cloud_mailboolean

Allow Cloud Mail. Default: true

allow_cloud_calenderboolean

Allow Cloud Calender. Default: true

allow_cloud_remindersboolean

Allow Cloud Reminders. Default: true

allow_cloud_addressbookboolean

Allow Cloud Addressbook. Default: true

allow_cloud_notesboolean

Allow Cloud Notes. Default: true

gatekeeper_settingstring

Gatekeeper app source restriction. Allowed values: 1=App Store Only, 2=App Store and Identified Developers, 3=Anywhere, 4=Not Configured. Default: 3

allow_override_gatekeeperboolean

Allow Override Gatekeeper. Default: false

allow_dictationboolean

Allow Dictation. Default: true

allow_assistantboolean

Allow Assistant. Default: true

allow_use_of_ibookstoreboolean

Allow Use Of Ibookstore. Default: true

allow_ibookstore_erotica_mediaboolean

Allow Ibookstore Erotica Media. Default: true

movies_rating_valuestring

Movie content rating filter. Allowed values vary by country. US values: 0=Don't Allow, 100=G, 200=PG, 300=PG-13, 400=R, 500=NC-17, 1000=Allow All Movies. Default: 1000

tv_shows_rating_valuestring

TV show content rating filter. Allowed values vary by country. US values: 0=Don't Allow, 100=TV-Y, 200=TV-Y7, 300=TV-G, 400=TV-PG, 500=TV-14, 600=TV-MA, 1000=Allow All TV Shows. Default: 1000

apps_rating_valuestring

App Store content rating filter. Allowed values vary by country. US values: 0=Don't Allow, 100=4+, 200=9+, 300=12+, 600=17+, 1000=Allow All Apps. Default: 1000

allow_find_my_friendboolean

Allow Find My Friend. Default: true

allow_find_my_deviceboolean

Allow Find My Device. Default: true

allow_erase_content_settingsboolean

Allow Erase Content Settings. Default: true

is_rating_enabledboolean

Is Rating Enabled. Default: false

country_codestring

Country Code. Default: us

allow_cloud_private_relayboolean

Allow Cloud Private Relay. Default: true

allow_usb_restriction_modeboolean

Allow Usb Restriction Mode. Default: true

allow_universal_controlboolean

Allow Universal Control. Default: true

allow_profile_installationboolean

Allow Profile Installation. Default: true

allow_rapid_security_response_installationboolean

Allow Rapid Security Response Installation. Default: true

allow_rapid_security_response_removalboolean

Allow Rapid Security Response Removal. Default: true

allow_airdropboolean

Allow Airdrop. Default: true

allow_bluetooth_modificationboolean

Allow Bluetooth Modification. Default: true

bluetooth_settingstring

Bluetooth setting. Allowed values: 0=Off, 1=On, 2=Not Configured

allow_marketplace_app_installationboolean

Allow Marketplace App Installation. Default: true

allow_web_distribution_app_installationboolean

Allow Web Distribution App Installation. Default: true

allow_modifi_passcodeboolean

Allow Modifi Passcode. Default: true

allow_diagnostic_submissionboolean

Allow Diagnostic Submission. Default: True

allow_apple_personalized_adsboolean

Allow Apple Personalized Ads. Default: True

allow_iphone_mirroringboolean

Allow Iphone Mirroring. Default: True

allow_modifi_device_nameboolean

Allow Modifi Device Name. Default: True

allow_cloud_freeformboolean

Allow Cloud Freeform. Default: True

enforced_fingerprint_timeoutstring

Enforced Fingerprint Timeout. Default: 172800

allow_modify_touch_idboolean

Allow Modify Touch Id. Default: True

allow_printer_sharing_modificationboolean

Allow Printer Sharing Modification. Default: True

allow_file_sharing_modificationboolean

Allow File Sharing Modification. Default: True

allow_internet_sharing_modificationboolean

Allow Internet Sharing Modification. Default: True

allow_bluetooth_sharing_modificationboolean

Allow Bluetooth Sharing Modification. Default: True

allow_time_machine_backupboolean

Allow Time Machine Backup. Default: True

allow_multiplayer_gamingboolean

Allow Multiplayer Gaming. Default: True

allow_local_user_creationboolean

Allow Local User Creation. Default: True

airplay_incoming_requestboolean

Airplay Incoming Request. Default: True

allow_account_modificationboolean

Allow Account Modification. Default: True

allow_ard_remote_management_modificationboolean

Allow Ard Remote Management Modification. Default: True

allow_startup_disk_modificationboolean

Allow Startup Disk Modification. Default: True

allow_remote_apple_events_modificationboolean

Allow Remote Apple Events Modification. Default: True

allow_image_playgroundboolean

Allow Image Playground. Default: True

allow_writing_toolsboolean

Allow Writing Tools. Default: True

allow_external_intelligence_integrationsboolean

Allow External Intelligence Integrations. Default: True

force_delayed_software_updatesboolean

Force Delayed Software Updates. Default: False

force_delayed_app_software_updatesboolean

Force Delayed App Software Updates. Default: False

force_delayed_major_software_updatesboolean

Force Delayed Major Software Updates. Default: False

software_update_delaystring

Software Update Delay. Default: 30

software_update_minor_os_deferred_install_delaystring

Software Update Minor Os Deferred Install Delay. Default: 30

software_update_major_os_deferred_install_delaystring

Software Update Major Os Deferred Install Delay. Default: 30

software_update_non_os_deferred_install_delaystring

Software Update Non Os Deferred Install Delay. Default: 30

allow_external_intelligence_integrations_signinboolean

Allow External Intelligence Integrations Signin. Default: True

allow_mail_summaryboolean

Allow Mail Summary. Default: True

allow_notes_transcription_summaryboolean

Allow Notes Transcription Summary. Default: True

allow_external_intelligence_workspace_idsstring

Allow External Intelligence Workspace Ids

force_bypass_screen_capture_alertboolean

Force Bypass Screen Capture Alert. Default: False

allow_media_sharing_modificationboolean

Allow Media Sharing Modification. Default: False

allow_apple_intelligence_reportboolean

Allow Apple Intelligence Report. Default: True

allow_mail_smart_repliesboolean

Allow Mail Smart Replies. Default: True

allow_safari_summaryboolean

Allow Safari Summary. Default: True

allow_safari_private_browsingboolean

Allow Safari Private Browsing. Default: True

allow_safari_history_clearingboolean

Allow Safari History Clearing. Default: True

Possible Response Codes

200HTTP code

Sample Response: HTTP 200

Restrictions payload item successfully modified

Copied!

  {
    "allow_activity_continuation": true,
    "payload_id": 9007199254741000,
    "safari_allow_autofill": true,
    "force_assist_profanity_filter": false,
    "allow_cloud_document_sync": true,
    "allow_game_center": true,
    "allow_use_of_camera": true,
    "allow_touch_id": true,
    "allow_modifi_wallpaper": true,
    "allow_spotlight_result": true,
    "allow_cloud_keychain_sync": true
  }

▼ Show full

Duration: 1 minute | Threshold: 60 | 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.