updateSiteSettings - Generic

PUT https://{{host}}/api/v1/sites/:site_id/setting

#### Body Parameter Parameter|Type|Description :-------------: |:-------------: |:-------------: analytic.enabled|boolean|enable Advanced Analytic feature, default is false (using SUB-ANA license) appwaking|boolean|default is false autoupgrade|object|auto upgrade bandwidth|int|channel width for the band, 20 / 40 / 80, 80 is only applicable for band5 bleconfig|object|BLE config (see Site:BLE Config) ble|object|BLE asset settings brightness|int|0-255, default is 255 channel|int|(primary) channel for the band, 0 means auto channels|list|list of channels, null or empty array means auto deviceupdownthreshold|int|sending APDISCONNECTED event in device-updowns only if APCONNECTED is not seen within the threshold, in minutes, 0 - 30, default is 0 flags|list|name/val pair objects for location engine to use hellointerval|float|in seconds, used as heartbeat to detect if a tunnel is alive. AP will try another peer after missing N hellos specified by helloretries. between 1 and 300, default is 60 seconds helloretries|int|between 2 and 30, default is 7 led.enabled|boolean|whether to enable LED, default is true led|object|LED control modelspecific|object|overwrites for a specific model. If a band is specified, it will shadow the default. mxtunnel.mtu|int|552-1500, default is 0 ntpservers|list|list of NTP servers persistconfigondevice|boolean|whether to store the config on AP, default is false powermax|int|when power=0, min tx power to use, HW-specific values will be used if not set powermin|int|when power=0, min tx power to use, HW-specific values will be used if not set power|int|tx power of the radio, 0 mean auto preamble|string|short / long / auto, default is short proxy|object|Proxy Configuration for APs to talk to Mist radioconfig|object|site RF settings remotesyslog|object|syslog parameters reportgatt|boolean|default is false; whether AP should periodically connect to BLE devices and report GATT device info (device name, manufacturer name, serial number, battery %, temperature, humidity) rogue|object|rogue detection parameters rtsa|object|managed mobility sshkeys|list|when limitsshaccess = true in Org Setting, list of SSH public keys provided by Mist Support to install onto APs (see Org:Setting) trackanonymousdevices|boolean|default is false; whether to track anonymous BLE assets (requires ‘trackasset’ enabled) trackasset|boolean|enable Asset Tracking, default is false (using SUB-AST license) vars|object|a dictionary of name->value, the vars can then be used in Wlans wifi|object|managed connectivity

#### Wi-Fi Parameter Parameter|Type|Description :-------------: |:-------------: |:-------------: enabled|boolean|enable WIFI feature, default is true (using SUB-MAN license) enablearpspoofcheck|boolean|when proxyarp is enabled, check for arp spoofing. default is false enablechannel144|boolean|whether to enable channel 144 (some older clients may not support in US), default is false enablevna|boolean|enable Virtual Network Assistant, default is false (using SUB-VNA license) proxyarp|string|default / enabled / disabled locateunconnected|boolean|whether to locate unconnected clients, default is false meshenabled|boolean|whether to enable Mesh feature for the site, default is false disable_11k|boolean|whether to disable 11k, default is false

#### Remote Syslog Parameter Parameter|Type|Description :-------------: |:-------------: |:-------------: enabled|boolean|whether or not remote syslog is enabled servers|list|list of syslog servers host|string|host to which syslog is sent protocol|string|udp / tcp, protocol to use for remote syslog, default is udp port|int|port on which to connect to host for syslog, default is 514 if protocol=udp, 6514 if protocol=tcp facility|string|kern / user / mail / daemon / auth / syslog / lpr / news / uucp / cron / authpriv / ftp / ntp / security / console / solaris-cron / local0 - local7, default is config severity|string|emerg / alert / crit / err / warning / notice / info / debug, default is info tag|string|optional, tag to attach to log record

#### Rogue Detection Parameter Parameter|Type|Description :-------------: |:-------------: |:-------------: enabled|boolean|whether or not rogue detection is enabled honeypotenabled|boolean|whether or not honeypot detection is enabled minrssi|int|minimum RSSI for an AP to be considered rogue (ignoring APs that’s far away), default is -80. Minimum allowed value is -85. minduration|int|minimum duration for a bssid to be considered rogue, maximum is 59, default is 10 whitelistedssids|list|list of SSIDs to whitelist whitelisted_bssids|list|list of BSSIDs to whitelist

#### Auto Upgrade Parameter Parameter|Type|Description :-------------: |:-------------: |:-------------: enabled|boolean|whether auto upgrade should happen, default is false (Note that Mist may auto-upgrade if the version is not supported) version|string|desired version, beta / stable / custom, default is stable timeofday|string|any / HH:MM (24-hour format), upgrade will happen within up to 1-hour from this time dayofweek|string|any / mon / tue / wed / thu / fri / sat / sun custom_versions|object|custome versions for different models

#### Engagement Parameter NOTE: if hours does not exist, it’s treated as everyday of the week, 00:00-23:59. Currently we don’t allow multiple ranges for the same day

NOTE: default values for dwell_tags: passerby (1,300) bounce (301, 14400) engaged (14401, 28800) stationed (28801, 42000)

NOTE: default values for dwelltagnames: passerby = “Passerby”, bounce = “Visitor”, engaged = “Associates”, stationed = “Assets”

ParameterTypeDescription
dwell_tagsobjectadd tags to visits within the duration (in seconds), available tags (passerby, bounce, engaged, stationed)
max_dwellintmax time, default is 43200(12h), max is 68400 (18h)
min_dwellintmin time, default is 0.
hoursobjecthours of operation filter, the available days (mon, tue, wed, thu, fri, sat, sun). Note: If the dow is not defined then it’s treated as 00:00-23:59.

#### WIDS Parameter Parameter|Type|Description :-------------: |:-------------: |:-------------: threshold|int|count of events to trigger duration|int|window where a trigger will be detected and action to be taken (in seconds)

#### Tunnel Parameter Parameter|Type|Description :-------------: |:-------------: |:-------------: hosts|list|hostnames or IPs where a Mist Tunnel will use as the Peer (i.e. they are reachable from AP) apsubnets|list|list of subnets where we allow AP to establish Mist Tunnels from protocol|list|udp / ip, default is udp vlanids|list|list of vlanids that will be used hellointerval|float|in seconds, used as heartbeat to detect if a tunnel is alive. AP will try another peer after missing N hellos specified by helloretries. between 1 and 300, default is 60 seconds helloretries|int|between 2 and 30, default is 7

Request Body

{"rtsa"=>{"enabled"=>false, "track_asset"=>false}}

HEADERS

KeyDatatypeRequiredDescription
Content-Typestring
Acceptstring
X-CSRFTokenstring