Save Remote Settings Bundle

Creates a new remote settings bundle or updates an existing one. Remote settings bundles are collections of configuration settings that can be applied to devices.

Available Settings Item Types (@class field):

  • WiFi Settings (com.viso.entities.remotesettings.RemoteSettingsItemWifi): Configure WiFi networks including WPA2/WPA3 and 802.1x EAP enterprise authentication. See RemoteSettingsItemWifi schema for WiFi configuration options.
  • User Manager / Restrictions (com.viso.entities.remotesettings.RemoteSettingsItemUserManager): Configure Android device restrictions (60+ options) like brightness, mobile data, debugging, camera, etc. See RemoteSettingsItemUserManager schema for restriction options.
  • Device Manager (com.viso.entities.remotesettings.RemoteSettingsItemDeviceManager): Device-level management settings.
  • Miscellaneous Settings (com.viso.entities.remotesettings.RemoteSettingsItemMisc): Wallpaper, certificates, time/date, locale, hotspot, network settings, and more. See RemoteSettingsItemMisc schema for all available options.
  • APN Settings (com.viso.entities.remotesettings.RemoteSettingsItemApn): Cellular network APN configuration.

Request Structure:

{
  "settingsBundleId": "optional-id-for-update",
  "settingsBundleName": "My Settings Bundle",
  "description": "Optional description",
  "color": "#3F51B5",
  "fontIcon": "fa-wifi",
  "remoteSettingsItems": [
    {
      "@class": "com.viso.entities.remotesettings.RemoteSettingsItemWifi",
      "itemName": "Office WiFi",
      "wifiSettingsDatas": [{"ssid": "Corp-Net", "password": "***", "securityType": "WPA2"}]
    },
    {
      "@class": "com.viso.entities.remotesettings.RemoteSettingsItemMisc",
      "itemName": "Wallpaper & Time",
      "settingsMap": {
        "showwp": true,
        "wpUrl": "https://example.com/wallpaper.jpg",
        "set_time_zone": "America/New_York"
      }
    }
  ]
}

Behavior:

  • If settingsBundleId is empty/null: Creates new bundle with auto-generated ID
  • If settingsBundleId is provided: Updates existing bundle

Returns: The saved bundle ID in the response

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params

Remote Settings Bundle - a collection of configuration settings that can be applied to Android devices. Bundles can contain WiFi configurations, device restrictions, APN settings, device management options, and miscellaneous settings.

string

Unique identifier for the settings bundle

string
required

Display name for the settings bundle

string

Optional description explaining the purpose of this settings bundle

string

Domain/tenant identifier for multi-tenant environments

string

Owner/creator of this settings bundle

string
enum

Type of settings bundle

Allowed:
string

Color code for UI display

string

Font icon identifier for UI display

boolean

Whether this is a private bundle visible only to the creator

boolean

Whether this item is hidden from other users. Optional field, defaults to false.

boolean

Whether this bundle is read-only and cannot be modified

moreData
object

Additional metadata for the bundle

accountList
array of strings

List of account IDs that this bundle is associated with

accountList
remoteSettingsItems
array of objects
remoteSettingsItems
date-time

Timestamp when this settings bundle was created

boolean
Responses

400

Bad Request

401

Unauthorized

403

Forbidden

429

Too Many Requests

503

Service Unavailable

Language
Credentials
Bearer
JWT
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json