Modify the configuration of a Kiosk payload item within a profile

Open in ChatGPT Open in ChatGPT to ask questions about this page
Open in Claude Open in Claude to ask questions about this page
Copy as MarkdownCopy this page as markdown to use with AI assistants
View as Markdown Open this page as markdown in a new tab

Modify Android Kiosk policy payload

Request URL

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

Scope

MDMDeviceMgmt.UPDATECopied!

Header

Authorization: d92d4xxxxxxxxxxxxx15f52

Request Parameters

- Request Headers

Content-TypestringMandatory
application/jsonapplication/jsonCopied!
AcceptstringMandatory
application/jsonapplication/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
sub_configstringOptional

Sub-configuration type identifier

kiosk_modeintegerOptional

Kiosk mode. 0 = Single App, 1 = Multi App, 3 = Single Web App (COSU). Default: 0

launcher_typeintegerOptional

Launcher type. 1 = Default device launcher, 2 = ME MDM custom launcher. Default: 2

allowed_appsJSON ArrayOptional

List of apps allowed in kiosk mode

Show Sub-Attributes
JSON Object
Show Sub-Attributes
group_display_namestringOptional

Display name of the app or app group

app_idlongOptional

Unique identifier of the app group

background_appsJSON ArrayOptional

List of apps that run in the background during kiosk mode

Show Sub-Attributes
JSON Object
Show Sub-Attributes
group_display_namestringOptional

Display name of the app or app group

app_idlongOptional

Unique identifier of the app group

enable_default_appbooleanOptional

Whether a default app is launched automatically in kiosk mode. Default: false

default_kiosk_appJSON ArrayOptional

The default app launched automatically when kiosk mode starts (single app)

Show Sub-Attributes
JSON Object
Show Sub-Attributes
group_display_namestringOptional

Display name of the app or app group

app_idlongOptional

Unique identifier of the app group

default_app_launch_modeintegerOptional

Default app launch behavior. Default: 0

default_app_launch_timeoutintegerOptional

Seconds of idle time before the default app is relaunched. Default: 20

wallpaperlongOptional

Wallpaper image file ID

is_wallpaper_removedbooleanOptional

Whether the kiosk wallpaper image has been removed. Default: false

show_me_mdm_appbooleanOptional

Whether the ME MDM app is visible on the kiosk launcher. Default: true

allow_notification_badgebooleanOptional

Whether notification badges are shown on app icons in kiosk mode. Default: false

allow_task_managerbooleanOptional

Whether the task manager is accessible in kiosk mode. Default: true

allow_system_barbooleanOptional

Whether the system bar is visible in kiosk mode. Default: true

allow_navigation_barbooleanOptional

Whether the navigation bar is visible in kiosk mode. Default: true

allow_status_barbooleanOptional

Whether the status bar is visible in kiosk mode. Default: true

allow_status_bar_expansionbooleanOptional

Whether the status bar can be expanded in kiosk mode. Default: true

allow_home_buttonbooleanOptional

Whether the home button is functional in kiosk mode. Default: true

allow_power_buttonbooleanOptional

Whether the power button is functional in kiosk mode. Default: true

allow_back_buttonbooleanOptional

Whether the back button is functional in kiosk mode. Default: true

allow_shutdownbooleanOptional

Whether the device can be shut down in kiosk mode. Default: true

allow_key_guardbooleanOptional

Whether the key guard (lock screen) is enabled in kiosk mode. Default: true

allow_notificationbooleanOptional

Whether notifications are shown in kiosk mode. Default: true

allow_system_error_dialogbooleanOptional

Whether app crash dialogs are displayed in kiosk mode. Default: false

allow_recent_appsbooleanOptional

Whether the recent apps view is accessible in kiosk mode. Default: true

allow_custom_settingsbooleanOptional

Whether the custom settings app is enabled in kiosk mode. Default: true

is_stay_awake_on_chargingbooleanOptional

Whether the device stays awake while charging in kiosk mode. Default: true

allow_simunlockbooleanOptional

Whether SIM unlock is allowed in kiosk mode. Default: true

allow_multiwindowbooleanOptional

Whether multi-window (split screen) mode is allowed in kiosk mode. Default: true

kiosk_custom_settingsJSON ObjectOptional

Advanced kiosk device feature controls configuration

Show Sub-Attributes
allow_wifibooleanOptional

Whether the user can access Wi-Fi settings in kiosk mode. Default: true

screen_orientationstringOptional

Forced screen orientation. Values: PORTRAIT, LANDSCAPE, AUTO

allow_brightnessbooleanOptional

Whether the user can adjust screen brightness. Default: true

screen_timeoutstringOptional

Screen timeout duration in milliseconds. 0 = User controlled, 15000 = 15 sec, 30000 = 30 sec, 60000 = 1 min, 300000 = 5 min, 1800000 = 30 min, 2147483647 = Always on

allow_flash_lightbooleanOptional

Whether the flashlight is accessible in kiosk mode. Default: true

allow_mobile_networkbooleanOptional

Whether mobile network settings are accessible. Default: true

allow_mobile_hotspot_settingsbooleanOptional

Whether mobile hotspot settings are accessible. Default: true

hotspot_settings_timeoutintegerOptional

Seconds before hotspot settings panel auto-closes. Default: 30

allow_bluetooth_settingsbooleanOptional

Whether Bluetooth settings are accessible. Default: true

bluetooth_settings_timeoutintegerOptional

Seconds before Bluetooth settings panel auto-closes. Default: 30

allow_apn_settingsbooleanOptional

Whether APN settings are accessible. Default: true

apn_settings_timeoutintegerOptional

Seconds before APN settings panel auto-closes. Default: 30

settings_timeoutintegerOptional

General settings panel timeout in seconds. Default: 30

allow_wifi_network_configurationbooleanOptional

Whether the user can add or configure Wi-Fi networks. Default: true

allow_battery_optimizationbooleanOptional

Whether battery optimization settings are accessible. Default: true

allow_locale_settingsbooleanOptional

Whether language and locale settings are accessible. Default: true

allow_device_passcode_change_settingsbooleanOptional

Whether the user can change the device passcode from kiosk mode. Default: true

allow_display_settingsbooleanOptional

Whether display settings are accessible. Default: true

battery_optimized_appsJSON ArrayOptional

List of apps exempt from battery optimization in kiosk mode

Show Sub-Attributes
JSON Object
Show Sub-Attributes
group_display_namestringOptional

Display name of the app or app group

app_idlongOptional

Unique identifier of the app group

mobile_data_usagebooleanOptional

Whether the user can view or manage mobile data usage. Default: true

default_keyboardbooleanOptional

Whether only the default keyboard is allowed. Default: true

allow_location_settingsbooleanOptional

Whether location settings are accessible. Default: true

allow_airplane_modebooleanOptional

Whether the user can toggle airplane mode. Default: true

allow_locationbooleanOptional

Whether location services are enabled on the device. Default: true

allow_nfc_settingsbooleanOptional

Whether NFC settings are accessible. Default: true

allow_datetime_settingsbooleanOptional

Whether date and time settings are accessible. Default: true

allow_accessibility_settingsbooleanOptional

Whether accessibility settings are accessible. Default: true

auto_distribute_appsbooleanOptional

Whether kiosk apps are automatically distributed to the device. Default: true

webclippoliciesJSON ArrayOptional

List of web shortcuts displayed on the kiosk home screen

Show Sub-Attributes
JSON Object
Show Sub-Attributes
webclip_policy_idlongOptional

Unique identifier of the web shortcut policy

webclip_namestringOptional

Display name of the web shortcut shown on the kiosk home screen

auto_distribute_webappbooleanOptional

Whether kiosk web shortcuts are automatically distributed. Default: true

exit_kiosk_passwordstringOptional

Password required to exit kiosk mode (write-only; use exit_kiosk_password_id for credential ID reads)

exit_kiosk_password_idlongOptional

ID of the saved password credential for kiosk exit

idle_refresh_timeoutintegerOptional

Seconds of idle time before web shortcuts are refreshed. -1 = Disabled. Default: -1

clear_cookies_on_idle_timeoutbooleanOptional

Whether cookies are cleared when the idle refresh timeout triggers. Default: true

clear_cache_on_idle_timeoutbooleanOptional

Whether cache is cleared when the idle refresh timeout triggers. Default: false

Sample Request

Curl
Java
Python
Deluge
PowerShell
Copied!
curl --request PUT \
  --url https://appdomain/api/v1/mdm/profiles/{profile_id}/payloads/androidkioskpolicy/payloaditems/{payload_id} \
  --header 'Accept: application/json' \
  --header 'Authorization:  d92d4xxxxxxxxxxxxx15f52' \
  --header 'Content-Type: application/json' \
  --data '{"enable_default_app":false,"launcher_type":2,"default_kiosk_app":[],"wallpaper":"value","sub_config":"KIOSK_CUSTOM_SETTINGS","default_app_launch_timeout":20,"allowed_apps":[],"default_app_launch_mode":0,"kiosk_mode":0,"background_apps":[]}'

Sample Request Body

Modify Kiosk payload item

Copied!
  {
    "enable_default_app": false,
    "launcher_type": 2,
    "default_kiosk_app": [],
    "wallpaper": "value",
    "sub_config": "KIOSK_CUSTOM_SETTINGS",
    "default_app_launch_timeout": 20,
    "allowed_apps": [],
    "default_app_launch_mode": 0,
    "kiosk_mode": 0,
    "background_apps": []
  }
                
Show full

Response Parameters

- HTTP code 200

Response Body - application/json
JSON Object
Hide Sub-Attributes
payload_idlong

Unique identifier of the payload item

sub_configstring

Sub-configuration type identifier

kiosk_modeinteger

Kiosk mode. 0 = Single App, 1 = Multi App, 3 = Single Web App (COSU). Default: 0

launcher_typeinteger

Launcher type. 1 = Default device launcher, 2 = ME MDM custom launcher. Default: 2

allowed_appsJSON Array

List of apps allowed in kiosk mode

Show Sub-Attributes
JSON Object
Show Sub-Attributes
group_display_namestring

Display name of the app or app group

app_idlong

Unique identifier of the app group

background_appsJSON Array

List of apps that run in the background during kiosk mode

Show Sub-Attributes
JSON Object
Show Sub-Attributes
group_display_namestring

Display name of the app or app group

app_idlong

Unique identifier of the app group

enable_default_appboolean

Whether a default app is launched automatically in kiosk mode. Default: false

default_kiosk_appJSON Array

The default app launched automatically when kiosk mode starts (single app)

Show Sub-Attributes
JSON Object
Show Sub-Attributes
group_display_namestring

Display name of the app or app group

app_idlong

Unique identifier of the app group

default_app_launch_modeinteger

Default app launch behavior. Default: 0

default_app_launch_timeoutinteger

Seconds of idle time before the default app is relaunched. Default: 20

wallpaperlong

Wallpaper image file ID

is_wallpaper_removedboolean

Whether the kiosk wallpaper image has been removed. Default: false

show_me_mdm_appboolean

Whether the ME MDM app is visible on the kiosk launcher. Default: true

allow_notification_badgeboolean

Whether notification badges are shown on app icons in kiosk mode. Default: false

allow_task_managerboolean

Whether the task manager is accessible in kiosk mode. Default: true

allow_system_barboolean

Whether the system bar is visible in kiosk mode. Default: true

allow_navigation_barboolean

Whether the navigation bar is visible in kiosk mode. Default: true

allow_status_barboolean

Whether the status bar is visible in kiosk mode. Default: true

allow_status_bar_expansionboolean

Whether the status bar can be expanded in kiosk mode. Default: true

allow_home_buttonboolean

Whether the home button is functional in kiosk mode. Default: true

allow_power_buttonboolean

Whether the power button is functional in kiosk mode. Default: true

allow_back_buttonboolean

Whether the back button is functional in kiosk mode. Default: true

allow_shutdownboolean

Whether the device can be shut down in kiosk mode. Default: true

allow_key_guardboolean

Whether the key guard (lock screen) is enabled in kiosk mode. Default: true

allow_notificationboolean

Whether notifications are shown in kiosk mode. Default: true

allow_system_error_dialogboolean

Whether app crash dialogs are displayed in kiosk mode. Default: false

allow_recent_appsboolean

Whether the recent apps view is accessible in kiosk mode. Default: true

allow_custom_settingsboolean

Whether the custom settings app is enabled in kiosk mode. Default: true

is_stay_awake_on_chargingboolean

Whether the device stays awake while charging in kiosk mode. Default: true

allow_simunlockboolean

Whether SIM unlock is allowed in kiosk mode. Default: true

allow_multiwindowboolean

Whether multi-window (split screen) mode is allowed in kiosk mode. Default: true

kiosk_custom_settingsJSON Object

Advanced kiosk device feature controls configuration

Show Sub-Attributes
allow_wifiboolean

Whether the user can access Wi-Fi settings in kiosk mode. Default: true

screen_orientationstring

Forced screen orientation. Values: PORTRAIT, LANDSCAPE, AUTO

allow_brightnessboolean

Whether the user can adjust screen brightness. Default: true

screen_timeoutstring

Screen timeout duration in milliseconds. 0 = User controlled, 15000 = 15 sec, 30000 = 30 sec, 60000 = 1 min, 300000 = 5 min, 1800000 = 30 min, 2147483647 = Always on

allow_flash_lightboolean

Whether the flashlight is accessible in kiosk mode. Default: true

allow_mobile_networkboolean

Whether mobile network settings are accessible. Default: true

allow_mobile_hotspot_settingsboolean

Whether mobile hotspot settings are accessible. Default: true

hotspot_settings_timeoutinteger

Seconds before hotspot settings panel auto-closes. Default: 30

allow_bluetooth_settingsboolean

Whether Bluetooth settings are accessible. Default: true

bluetooth_settings_timeoutinteger

Seconds before Bluetooth settings panel auto-closes. Default: 30

allow_apn_settingsboolean

Whether APN settings are accessible. Default: true

apn_settings_timeoutinteger

Seconds before APN settings panel auto-closes. Default: 30

settings_timeoutinteger

General settings panel timeout in seconds. Default: 30

allow_wifi_network_configurationboolean

Whether the user can add or configure Wi-Fi networks. Default: true

allow_battery_optimizationboolean

Whether battery optimization settings are accessible. Default: true

allow_locale_settingsboolean

Whether language and locale settings are accessible. Default: true

allow_device_passcode_change_settingsboolean

Whether the user can change the device passcode from kiosk mode. Default: true

allow_display_settingsboolean

Whether display settings are accessible. Default: true

battery_optimized_appsJSON Array

List of apps exempt from battery optimization in kiosk mode

Show Sub-Attributes
JSON Object
Show Sub-Attributes
group_display_namestring

Display name of the app or app group

app_idlong

Unique identifier of the app group

mobile_data_usageboolean

Whether the user can view or manage mobile data usage. Default: true

default_keyboardboolean

Whether only the default keyboard is allowed. Default: true

allow_location_settingsboolean

Whether location settings are accessible. Default: true

allow_airplane_modeboolean

Whether the user can toggle airplane mode. Default: true

allow_locationboolean

Whether location services are enabled on the device. Default: true

allow_nfc_settingsboolean

Whether NFC settings are accessible. Default: true

allow_datetime_settingsboolean

Whether date and time settings are accessible. Default: true

allow_accessibility_settingsboolean

Whether accessibility settings are accessible. Default: true

auto_distribute_appsboolean

Whether kiosk apps are automatically distributed to the device. Default: true

webclippoliciesJSON Array

List of web shortcuts displayed on the kiosk home screen

Show Sub-Attributes
JSON Object
Show Sub-Attributes
webclip_policy_idlong

Unique identifier of the web shortcut policy

webclip_namestring

Display name of the web shortcut shown on the kiosk home screen

auto_distribute_webappboolean

Whether kiosk web shortcuts are automatically distributed. Default: true

exit_kiosk_passwordstring

Password required to exit kiosk mode (write-only; use exit_kiosk_password_id for credential ID reads)

exit_kiosk_password_idlong

ID of the saved password credential for kiosk exit

idle_refresh_timeoutinteger

Seconds of idle time before web shortcuts are refreshed. -1 = Disabled. Default: -1

clear_cookies_on_idle_timeoutboolean

Whether cookies are cleared when the idle refresh timeout triggers. Default: true

clear_cache_on_idle_timeoutboolean

Whether cache is cleared when the idle refresh timeout triggers. Default: false

Possible Response Codes

200HTTP code

Sample Response: HTTP 200

Kiosk payload item successfully modified

Copied!
  {
    "enable_default_app": false,
    "payload_id": 9007199254741000,
    "launcher_type": 2,
    "default_kiosk_app": [],
    "wallpaper": "value",
    "sub_config": "KIOSK_CUSTOM_SETTINGS",
    "default_app_launch_timeout": 20,
    "allowed_apps": [],
    "default_app_launch_mode": 0,
    "kiosk_mode": 0,
    "background_apps": []
  }
                
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.