Juniper Mist AI Sites Devices API
Mist provides many ways (device_type specific template, site template, device profile, per-device) to configure devices for different kind of scenarios.The precedence goes from most specific to least specificDevice > Device Profile > RFTemplate (for AP only) > DeviceType-specific Template > Site Template > Site Setting
Juniper Mist AI Sites Devices API is one of 212 APIs that Juniper Mist AI publishes on the APIs.io network, described by a machine-readable OpenAPI specification.
Tagged areas include Sites Devices. The published artifact set on APIs.io includes an OpenAPI specification and API documentation.
This API exposes 16 operations across 14 paths, and defines 561 schemas. It is described by OpenAPI 3.2.0, at version 2604.1.1.
Requests are made against 12 base URLs: https://api.mist.com, https://api.gc1.mist.com, https://api.ac2.mist.com, https://api.gc2.mist.com, https://api.gc4.mist.com, https://api.eu.mist.com, https://api.gc3.mist.com, https://api.ac6.mist.com, https://api.gc6.mist.com, https://api.ac5.mist.com, https://api.gc5.mist.com, https://api.gc7.mist.com.
16 operations
14 paths
561 schemas
1 DELETE11 GET3 POST1 PUT
Metadata
The identity and technical contract details declared by the specification.
Authentication & Security 3
Juniper Mist AI Sites Devices API declares
3 security schemes
for authenticating requests.
An API key is passed in the header as Authorization (apiToken).
It accepts HTTP basic authentication (basicAuth).
An API key is passed in the header as X-CSRFToken (csrfToken).
By default, every request must be authenticated.
apiToken— Like many other API providers, it’s also possible to generate API Tokens to be used (in HTTP Header) for authentication. An API token ties to a Admin with equa…basicAuth— While our current UI uses Session / Cookie-based authentication, it’s also possible to do Basic Auth.csrfToken— This protects the website against [Cross Site Request Forgery](https://en.wikipedia.org/wiki/Cross-siterequestforgery), all the POST / PUT / DELETE APIs needs…
Paths & Operations 16
Across 14 paths, the API surfaces 16 operations — 1 DELETE, 11 GET, 3 POST, 1 PUT. Each is listed below with its method, path, parameters, and response codes.
Sites Devices 16
Mist provides many ways (devicetype specific template, site template, device profile, per-device) to configure devices for different kind of scenarios. The precedence goes from mo…
GET
/api/v1/sites/{site_id}/devices
listSiteDevices
GET
/api/v1/sites/{site_id}/devices/config_history/count
countSiteDeviceConfigHistory
GET
/api/v1/sites/{site_id}/devices/config_history/search
searchSiteDeviceConfigHistory
GET
/api/v1/sites/{site_id}/devices/count
countSiteDevices
GET
/api/v1/sites/{site_id}/devices/events/count
countSiteDeviceEvents
GET
/api/v1/sites/{site_id}/devices/events/search
searchSiteDeviceEvents
GET
/api/v1/sites/{site_id}/devices/export
exportSiteDevices
POST
/api/v1/sites/{site_id}/devices/gbp_tag
setSiteDevicesGbpTag
POST
/api/v1/sites/{site_id}/devices/import
importSiteDevices
GET
/api/v1/sites/{site_id}/devices/last_config/count
countSiteDeviceLastConfig
GET
/api/v1/sites/{site_id}/devices/last_config/search
searchSiteDeviceLastConfigs
GET
/api/v1/sites/{site_id}/devices/search
searchSiteDevices
GET
/api/v1/sites/{site_id}/devices/{device_id}
getSiteDevice
PUT
/api/v1/sites/{site_id}/devices/{device_id}
updateSiteDevice
DELETE
/api/v1/sites/{site_id}/devices/{device_id}/image/{image_number}
deleteSiteDeviceImage
POST
/api/v1/sites/{site_id}/devices/{device_id}/image/{image_number}
addSiteDeviceImage
Schemas 561
The contract defines 561 schemas that model the data the API accepts and returns. The most detailed are device_switch (63 properties), gateway_port_config (48 properties), device_ap (47 properties), device_gateway (47 properties). Each schema is shown below with its type and property counts.
switch_port_usage_dynamic_rule
object
6 properties
1 required
switch_mist_nac
object
Enable mistnac to use RadSec
2 properties
gateway_mgmt
object
Gateway Management settings
15 properties
switch_dhcpd_config_property
object
the Property key is the network name. In case of DHCP relay, it's common for many networks to use the same dhcp relay, comma-separated network names can be use…
16 properties
service_policy_skyatp_dns_tunnel_detection_profile
string
enum: default, standard, strict
dhcpd_config_property
object
16 properties
radius_acct_server
object
7 properties
2 required
ntp_servers
array
List of NTP servers specific to this device. By default, those in Site Settings will be used
junos_port_config
object
Switch port config
18 properties
1 required
vrf_extra_route6
object
1 property
gateway_ip_configs
object
Property key is the network name
remote_syslog_server_protocol
string
enum: tcp, udp
ospf_area
object
Property key is the OSPF Area (Area should be a number (0-255) / IP address)
3 properties
tunnel_config
object
18 properties
network_multicast_groups
object
Group address to RP (rendezvous point) mapping. Property Key is the CIDR (example "225.1.0.3/32")
strings
array
network_source_nat
object
If routed==false (usually at Spoke), but some hosts needs to be reachable from Hub
1 property
sw_routing_policy_term_action
object
When used as import policy
4 properties
tunnel_config_probe_type
string
enum: http, icmp
switch_bgp_config_hold_time_zero
integer
radsec
object
RadSec settings
9 properties
const_device_type_switch
string
Device Type. enum: switch
vrrp_config_groups
object
Property key is the VRRP name
routing_policy_term_matching_prefix
array
zero or more criteria/filter can be specified to match the term, all criteria have to be met
gateway_ip_config_property
object
7 properties
ap_mesh
object
Mesh AP settings
5 properties
ap_search_wlan
object
2 properties
remote_syslog_users
array
switch_bgp_config_neighbors
object
Property key is the BGP Neighbor IP Address.
idp_profile_matching
object
3 properties
switch_radius_config
object
Junos Radius config
12 properties
dhcpd_config_vendor_option
object
2 properties
ospf_area_type
string
OSPF type. enum: default, nssa, stub
service_policy_skyatp_iot_device_policy
object
1 property
routing_policy_term_action_prepend_as_path
array
When used as export policy, optional. By default, the local AS will be prepended, to change it. Can be a Variable (e.g. {{aspath}})
ip_type6
string
enum: autoconf, dhcp, disabled, static
vrf_extra_routes
object
Property key is the destination CIDR (e.g. "10.0.0.0/8")
gateway_port_config
object
Gateway port config
48 properties
1 required
network_tenants
object
Property key must be the user/tenant name (i.e. "printer-1") or a Variable (i.e. "{{myvar}}")
switch_bgp_config_neighbor
object
5 properties
1 required
ospf_area_network_interface_type
string
interface type (nbma = non-broadcast multi-access). enum: broadcast, nbma, p2mp, p2p
snmp_config_client_list
object
2 properties
ibeacon_minor
integernull
Minor number for iBeacon
gateway_path_preferences
object
2 properties
switch_mgmt_mxedge_proxy_port
Mist Edge port used to proxy the switch management traffic to the Mist Cloud. Value in range 1-65535
aggregate_route
object
3 properties
switch_search
object
24 properties
1 required
switch_port_local_usage_mode
string
enum: access, inet, trunk
gateway_extra_routes6
object
Property key is the destination CIDR (e.g. "2a02:1234:420a:10c9::/64"), the destination Network name or a variable (e.g. "{{myvar}}")
dhcp_snooping
object
5 properties
tunnel_config_provider
string
Only if autoprovision.enabled==false. enum: custom-ipsec, custom-gre, jse-ipsec, prisma-ipsec, zscaler-gre, zscaler-ipsec
gateway_ip_config_property_second_ips
array
Optional list of secondary IPs in CIDR format
dot11_bandwidth24
integer
channel width for the 2.4GHz band. enum: 0(disabled, response only), 20, 40
remote_syslog_servers
array
sw_routing_policy_term_matching_protocol_enum
string
enum: bgp, direct, evpn, ospf, static
network_internet_access_static_nat
object
Property key may be an External IP Address (i.e. "63.16.0.3"), a CIDR (i.e. "63.16.0.12/20") or a Variable (i.e. "{{myvar}}")
idp_profile_matching_severity
array
tunnel_config_ipsec_proposals
array
Only if provider==custom-ipsec
site_device_events_count_distinct
string
enum: mac, model, type, typecode
ap_airista
object
3 properties
snmp_config_engine_id_type
string
enum: local, usemacaddress
gateway_mgmt_probe_hostsv6
array
switch_port_local_usage_storm_control
object
Switch storm control
6 properties
switch_port_usage_dynamic_rule_src
string
enum: linkpeermac, lldpchassisid, lldphardwarerevision, lldpmanufacturername, lldpoui, lldpserialnumber, lldpsystemdescription, lldpsystemname, radiusdynamicfi…
snmp_config_trap_groups
array
snmp_vacm_access_item_type
string
enum: contextprefix, defaultcontextprefix
snmpv3_config_notify_items
object
3 properties
switch_bgp_config
object
9 properties
2 required
snmp_vacm_access_item
object
2 properties
idp_profile_action
string
enum: alert (default) drop: silently dropping packets close: notify client/server to close connection
day_of_week
string
enum: any, fri, mon, sat, sun, thu, tue, wed
idp_profile_matching_dst_subnet
array
switch_port_local_usage_dynamic_vlan_networks
array
Only if portauth==dot1x, if dynamic vlan is used, specify the possible networks/vlans RADIUS can return
switch_dhcpd_config_dns_suffix
array
If type==server or type6==server - optional, if not defined, system one will be used
extra_route
object
6 properties
response_config_history_search_results
array
wan_extra_routes
object
1 property
gateway_idp_profiles
object
Property key is the profile name
config_switch_local_accounts
object
Property key is the user name. For Local user authentication
tunnel_config_tunnel_mode
string
Required if provider==zscaler-gre, provider==jse-ipsec. enum: active-active, active-standby
snmpv3_config_target_param_security_level
string
enum: authentication, none, privacy
snmp_config_client_list_clients
array
protect_re_trusted_hosts
array
host/subnets we'll allow traffic to/from
gw_routing_policy_term_action
object
When used as import policy
9 properties
switch_dhcpd_config_type6
string
enum: none, relay (DHCP Relay), server (DHCP Server)
vrf_extra_route
object
1 property
ap_led
object
LED AP settings
2 properties
junos_local_port_config
object
Switch port config
37 properties
1 required
snmp_usm_engine_type
string
enum: localengine, remoteengine
gw_routing_policy
object
1 property
gw_routing_policy_term_matching_route_exists
object
2 properties
gateway_path_preferences_paths
array
ap_radio_antenna_mode
string
enum: 1x1, 2x2, 3x3, 4x4, default
tunnel_config_auth_algo
string
enum: md5, sha1, sha2
dhcpd_config_options
object
If type==local or type6==local. Property key is the DHCP option number
acl_tag_ether_types
array
ARP / IPv6. Default is any
remote_syslog_time_format
string
enum: millisecond, year, year millisecond
ap_radio_band6
object
Radio Band AP settings
13 properties
switch_port_usage_dot1x
stringnull
Only if mode!=dynamic. If dot1x is desired, set to dot1x. enum: dot1x
network_vpn_access_static_nat_property
object
2 properties
service_policy_secintel_profile
string
enum: default, standard, strict
response_events_devices
object
6 properties
5 required
site_device_last_config_count_distinct
string
enum: mac, name, siteid, version
switch_port_usage_reauth_interval
Only if mode!=dynamic and portauth=dot1x reauthentication interval range (min: 10, max: 65535, default: 3600). Set to 0 to disable reauthentication (no-reauthe…
ssl_proxy_ciphers_category
string
enum: medium, strong, weak
gateway_port_mirroring
object
1 property
snmp_vacm_access_item_prefix_list_item
object
7 properties
gateway_port_mirroring_ingress_port_ids
array
gateway_wan_type
string
enum: dhcp, pppoe, static
vrrp_config
object
Junos VRRP config
2 properties
ap_port_config_forwarding
string
enum: all: local breakout, All VLANs limited: local breakout, only the VLANs configured in portvlanid and vlanids mxtunnel: central breakout to an Org Mist Edg…
device_search_radius_stats
object
Property key is the RADIUS server IP Address
local_port_config
object
Local port override, overriding the port configuration from portconfig. Property key is the port name or range (e.g. "ge-0/0/0-10")
ap_search_wlans
array
response_config_history_search
object
6 properties
5 required
search_site_devices_sort
string
enum: mac, model, sku, timestamp
extra_route6_next_qualified_properties
object
2 properties
extra_route6
object
6 properties
snmpv3_config_target_param_security_model
string
enum: usm, v1, v2c
network_internet_access_destination_nat_property
object
4 properties
routing_policy_term_action_community
array
When used as export policy, optional
count_result
object
1 property
1 required
switch_port_usage
object
Junos port usages
45 properties
ap_zigbee_allow_join
string
Controls whether new Zigbee devices are allowed to join the network. enum: always, manual
service_policy_syslog
object
Required for syslog logging
2 properties
service_policy_skyatp_dns_dga_detection_profile
string
enum: default, standard, strict
switch_port_usage_mac_limit_overwrite
Max number of mac addresses, default is 0 for unlimited, otherwise range is 1 to 16383 (upper bound constrained by platform)
idp_profile_overwrite
object
3 properties
service_policy_skyatp_dns_tunnel_detection
object
2 properties
service_policy_ewf_rule_profile
string
enum: critical, standard, strict
snmp_config_trap_group_categories
array
switch_port_usages
object
Property key is the port usage name. Defines the profiles of port configuration configured on the switch
tunnel_provider_options_zscaler
object
For zscaler-ipsec and zscaler-gre
15 properties
tunnel_provider_options_jse
object
For jse-ipsec, this allows provisioning of adequate resource on JSE. Make sure adequate licenses are added
2 properties
response_device_search_results_items
junos_port_config_duplex
string
enum: auto, full, half
ap_client_bridge
object
3 properties
org_id
string
tacacs_auth_server
object
4 properties
switch_radius_config_auth_server_selection
string
enum: ordered, unordered
switch_bgp_config_hold_time
Hold time is three times the interval at which keepalive messages are sent. It indicates to the peer the length of time that it should consider the sender vali…
ap_centrak
object
1 property
aggregate_routes
object
Property key is the destination subnet (e.g. "172.16.3.0/24")
bgp_config
object
BFD is enabled when either bfdminimuminterval or bfdmultiplier is configured
22 properties
1 required
gateway_port_reth_nodes
array
SSR only - supporting vlan-based redundancy (matching the size of networks)
snmpv3_config_notify_filter
array
extra_routes
object
Property key is the destination CIDR (e.g. "10.0.0.0/8")
ap_search
object
36 properties
4 required
binary_stream
object
1 property
1 required
gateway_vrf_instance
object
1 property
switch_port_usage_storm_control
object
Switch storm control. Only if mode!=dynamic
6 properties
msp_id
string
switch_port_usage_duplex_overwrite
string
Link connection mode. enum: auto, full, half
device_search_radius_stat
object
4 properties
mist_device
gateway_path_preferences_path_networks
array
Required when type==local
switch_port_usage_mac_limit
Only if mode!=dynamic, max number of mac addresses, default is 0 for unlimited, otherwise range is 1 to 16383 (upper bound constrained by platform)
switch_stp_config
object
1 property
routing_policy_term_matching_community
array
extra_route_next_qualified_properties
object
2 properties
switch_radius
object
By default, radiusconfig will be used. if a different one has to be used set usedifferentradius
3 properties
switch_port_mirroring_property
object
6 properties
switch_mgmt
object
Switch Management settings
16 properties
response_config_history_search_item
object
11 properties
5 required
ap_port_config
object
17 properties
snmp_vacm_access
array
service_policy_secintel
object
SRX only
3 properties
snmp_config_trap_group
object
4 properties
network_internet_access_destination_nat
object
Property key can be an External IP (i.e. "63.16.0.3"), an External IP:Port (i.e. "63.16.0.3:443"), an External Port (i.e. ":443"), an External CIDR (i.e. "63.1…
network_multicast_group
object
1 property
remote_syslog
object
10 properties
snmpv3_config_target_address_item
object
6 properties
gateway_port_duplex
string
enum: auto, full, half
tunnel_config_remote_subnets
array
List of Remote protected subnet for policy-based IPSec negotiation
routing_policy_term_matching_as_path
array
gateway_extra_route6
object
1 property
response_http403
object
1 property
gw_routing_policy_terms
array
zero or more criteria/filter can be specified to match the term, all criteria have to be met
tunnel_config_node_hosts
array
service_policy
object
15 properties
gateway_port_networks
array
If usage==lan, name of the [networks]($h/Orgs%20Networks/overview) to attach to the interface
service_policy_skyatp
object
SRX only
4 properties
snmp_vacm_security_model
string
enum: usm, v1, v2c
radio_band_24_usage
string
enum: 24, 5, 6, auto
gateway_port_vpn_path
object
5 properties
radsec_mxcluster_ids
array
To use Org mxedges when this WLAN does not use mxtunnel, specify their mxclusterids. Org mxedge(s) identified by mxclusterids
dhcpd_config_option
object
2 properties
mac_addresses_macs
array
gateway_traffic_shaping
object
3 properties
radio_band_antenna_mode
string
enum: 1x1, 2x2, 3x3, 4x4, default
service_policy_appqoe
object
SRX only
1 property
gateway_path_preferences_path
object
9 properties
1 required
remote_syslog_server_port
Syslog Service Port, value from 1 to 65535
ap_usb
object
USB AP settings - Note: if native imagotag is enabled, BLE will be disabled automatically - Note: legacy, new config moved to ESL Config.
8 properties
gateway_extra_route
object
1 property
acl_policies
array
snmp_vacm
object
2 properties
gateway_extra_routes
object
Property key is the destination CIDR (e.g. "10.0.0.0/8"), the destination Network name or a variable (e.g. "{{myvar}}")
tunnel_config_version
string
Only if provider==custom-gre or provider==custom-ipsec. enum: 1, 2
ap_ip_config_dns
array
If type==static
switch_port_mirroring_ingress_port_ids
array
At least one of the inputportidsingress, inputportidsegress or inputnetworksingress should be specified
switch_dhcpd_config_options
object
If type==server or type6==server. Property key is the DHCP option number
radio_band_preamble
string
enum: auto, long, short
network_vpn_access_config
object
14 properties
gateway_mgmt_auto_signature_update
object
3 properties
ip_type
string
enum: dhcp, static
created_time
number
When the object has been created, in epoch
snmp_usm_user
object
5 properties
remote_syslog_facility
string
enum: any, authorization, change-log, config, conflict-log, daemon, dfc, external, firewall, ftp, interactive-commands, kernel, ntp, pfe, security, user
snmp_config_v2c_configs
array
tunnel_via
string
If via==tunnel, specifies which tunnel (primary/secondary) this neighbor is associated with. enum: primary, secondary
ap_radio_band24
object
Radio Band AP settings
11 properties
vrf_extra_routes6
object
Property key is the destination CIDR (e.g. "2a02:1234:420a:10c9::/64")
bgp_config_neighbors
object
7 properties
1 required
radius_auth_port
Radius Auth Port, value from 1 to 65535, default is 1812
search_site_devices_desc_sort
string
enum: mac, model, sku, timestamp
tunnel_config_auto_provision_node_wan_names
array
Optional, only needed if varsonly==false
gateway_port_config_wan_speedtest_mode
string
Controls whether Marvis/scheduler can run speedtest on this port. enum: auto, enabled, disabled
gateway_oob_ip_config
object
Out-of-band (vme/em0/fxp0) IP config
8 properties
switch_port_usage_mac_auth_protocol
string
Only if mode!=dynamic and enablemacauth ==true. This type is ignored if mistnac is enabled. enum: eap-md5, eap-peap, pap
switch_bgp_config_type
string
enum: external, internal
app_probing
object
3 properties
network_tenant
object
1 property
idp_profile_base_profile
string
enum: critical, standard, strict
remote_syslog_content
object
2 properties
snmp_config_view
object
3 properties
response_count
object
6 properties
6 required
idp_profile_matching_severity_value
string
enum: critical, info, major, minor
switch_dhcpd_config_type
string
enum: none, relay (DHCP Relay), server (DHCP Server)
radsec_server
object
2 properties
switch_port_local_usage_duplex
string
link connection mode. enum: auto, full, half
response_config_history_search_item_radios
array
gateway_port_wan_source_nat
object
Only if usage==wan, optional. By default, source-NAT is performed on all WAN Ports using the interface-ip
3 properties
radius_auth_server
object
Authentication Server
8 properties
2 required
switch_oob_ip_config
object
Switch OOB IP Config: - If HA configuration: key parameter will be nodeX (eg: node1) - If there are 2 routing engines, re1 mgmt IP has to be set separately (if…
7 properties
switch_port_usage_dynamic_rules
array
Only if mode==dynamic
service_policy_antivirus
object
For SRX-only
3 properties
timestamp
number
Epoch (seconds)
acl_tag_macs
array
Required if - type==mac - type==staticgbp if from matching mac
protect_re_custom_subnet
array
switch_dhcpd_config_dns_servers
array
If type==server or type6==server - optional, if not defined, system one will be used
snmp_usm_user_authentication_type
string
sha224, sha256, sha384, sha512 are supported in 21.1 and newer release. enum: authentication-md5, authentication-none, authentication-sha, authentication-sha22…
snmp_vacm_security_to_group
object
2 properties
switch_iot_port_input_src
string
Only for "OUT" ports, input source for the switch iot port out. enum: IN0, IN1
dhcpd_config_vendor_options
object
If type==local or type6==local. Property key is : , with enterprise number: 1-65535 (https://www.iana.org/assignments/enterprise-numbers/enterprise-numbers) su…
switch_port_usage_duplex
string
Only if mode!=dynamic. Link connection mode. enum: auto, full, half
ha_cluster_node_enum
string
only for HA. enum: node0, node1
ap_radio_band5
object
Radio Band AP settings
12 properties
switch_port_local_usage_mac_auth_protocol
string
Only if enablemacauth ==true. This type is ignored if mistnac is enabled. enum: eap-md5, eap-peap, pap
ospf_areas
object
Junos OSPF areas. Property key is the OSPF Area (Area should be a number (0-255) / IP address)
switch_iot_port
object
Switch IOT port configuration
4 properties
gw_routing_policy_term_action_export_communities
array
When used as export policy, optional
remote_syslog_archive_files
dhcpd_config_fixed_bindings
object
If type==local or type6==local. Property key is the MAC Address. Format is [0-9a-f]{12} (e.g. "5684dae9ac8b")
snmp_vacm_access_item_prefix_list_item_level
string
enum: authentication, none, privacy
switch_networks
object
Property key is network name
tunnel_config_enc_algo
stringnull
enum: 3des, aes128, aes256, aesgcm128, aesgcm256
last_config_device_type
string
enum: ap, gateway, mxedge, switch
snmp_vacm_access_item_prefix_list
array
ap_port_config_dynamic_vlan
object
Optional dynamic vlan
4 properties
gateway_port_vlan_id_with_variable
If WAN interface is on a VLAN. Can be the VLAN ID (i.e. "10") or a Variable (i.e. "{{myvar}}")
sw_routing_policy
object
1 property
gateway_port_config_ip_config
object
Junos IP Config
14 properties
switch_port_mirroring_egress_port_ids
array
At least one of the inputportidsingress, inputportidsegress or inputnetworksingress should be specified
dhcpd_config_dns_servers
array
If type==local or type6==local - optional, if not defined, system one will be used
device_ap_lacp_config
object
1 property
snmpv3_config
object
6 properties
routing_policy_local_preference
Optional, for an import policy, localpreference can be changed, value in range 1-4294967294. Can be a Variable (e.g. {{bgpas}})
switch_iot_config
object
Property Key is the IOT port name, e.g.: IN0 or IN1 for the FPC0 input port with 5V triggered inputs OUT1 for the FPC0 output port (can only be triggered by ei…
snmpv3_config_target_address
array
bgp_local_as
Required if via==lan, via==tunnel or via==wan. BGP AS, value in range 1-4294967295
gateway_wan_ppoe_auth
string
if type==pppoe. enum: chap, none, pap
protect_re_allowed_service
string
enum: icmp, ssh
switch_port_mirroring_ingress_networks
array
At least one of the inputportidsingress, inputportidsegress or inputnetworksingress should be specified
ospf_area_network_auth_type
string
auth type. enum: md5, none, password
config_devices
array
acl_policy
object
ACL Policy: - for GBP-based policy, all srctags and dsttags have to be gbp-based - for ACL-based policy, network is required in either the source or destinatio…
3 properties
ap_radio
object
Radio AP settings
15 properties
radio_band_channels
arraynull
For RFTemplates. List of channels, null or empty array means auto
tunnel_config_auto_provision_lat_lng
object
API override for POP selection
2 properties
2 required
bgp_config_via
string
enum: lan, tunnel, vpn, wan
app_probing_custom_app_hostname
array
If protocol==http
service_policies
array
snmp_config_trap_group_targets
array
snmpv3_config_notify_filter_item_contents
array
network_internet_access
object
Whether this network has direct internet access
5 properties
app_probing_custom_app
object
10 properties
modified_time
number
When the object has been modified for the last time, in epoch
vars
object
Dictionary of name-value, the vars can then be used in Wlans. This can overwrite those from Site Vars
idp_config
object
4 properties
gateway_search
object
27 properties
1 required
remote_syslog_archive
object
2 properties
tunnel_config_ike_proposals
array
If provider==custom-ipsec
dhcp_snooping_networks
array
If allnetworks==false, list of network with DHCP snooping enabled
switch_bgp_config_hold_time_integer
integer
snmpv3_config_notify_type
string
enum: inform, trap
snmp_config_views
array
gw_routing_policy_term_action_exclude_community
array
snmpv3_config_target_param
object
6 properties
device_search_radius_filter_status
string
Status of the device search radius filter. enum: up, down, unreachable
image_import
object
2 properties
1 required
gateway_port_vpn_path_role
string
If the VPN type==hubspoke, enum: hub, spoke. If the VPN type==mesh, enum: mesh
snmp_usms
array
radio_band_antenna_beam_pattern
string
enum: narrow, medium, wide
poe_priority
string
PoE priority. enum: low, high
tunnel_config_ike_dh_group
string
enum: 1 2 (1024-bit) 5 14 (default, 2048-bit) 15 (3072-bit) 16 (4096-bit) 19 (256-bit ECP) 20 (384-bit ECP) 21 (521-bit ECP) 24 (2048-bit ECP)
ble_config_power_mode
string
enum: custom, default
dhcpd_config_servers
array
If type==relay
wan_extra_routes6
object
1 property
snmp_usm
object
3 properties
tunnel_config_node_remote_ids
array
Only if provider==jse-ipsec or provider==custom-ipsec
ap_aeroscout
object
Aeroscout AP settings
4 properties
sw_routing_policies
object
Property key is the routing policy name
switch_port_usage_dynamic_vlan_networks
array
Only if mode!=dynamic and portauth==dot1x, if dynamic vlan is used, specify the possible networks/vlans RADIUS can return
gateway_path_strategy
string
enum: ecmp, ordered, weighted
response_device_search_results
array
extra_routes6
object
Property key is the destination CIDR (e.g. "2a02:1234:420a:10c9::/64")
snmp_vacm_security_to_group_content
array
gateway_vrf_instances
object
Property key is the network name
ap_pwr_config
object
Power related configs
2 properties
switch_port_usage_speed_overwrite
string
Port Speed, default is auto to automatically negotiate speed enum: 100m, 10m, 1g, 2.5g, 5g, 10g, 25g, 40g, 100g,auto
network_tenant_addresses
array
response_config_history_search_item_wlan
object
5 properties
3 required
dot11_bandwidth5
integer
channel width for the 5GHz band. enum: 0(disabled, response only), 20, 40, 80
idp_profile_overwrites
array
allow_deny
string
enum: allow, deny
radsec_proxy_hosts
array
Default is site.mxedge.radsec.proxyhosts which must be a superset of all wlans[].radsec.proxyhosts. When radsec.proxyhosts are not used, tunnel peers (org or s…
wired_port_config
object
Property key is the port name or range (e.g. "ge-0/0/0-10")
tunnel_config_ike_proposal
object
3 properties
radsec_servers
array
List of RadSec Servers. Only if not Mist Edge.
junos_other_ip_config
object
Optional, if it's required to have switch's L3 presence on a network/vlan
7 properties
switch_network
object
A network represents a network segment. It can either represent a VLAN (then usually ties to a L3 subnet), optionally associate it with a subnet which can late…
7 properties
1 required
gateway_port_lte_auth
string
if wantype==lte. enum: chap, none, pap
gw_routing_policy_term
object
2 properties
gw_routing_policy_term_matching
object
zero or more criteria/filter can be specified to match the term, all criteria have to be met
9 properties
dot11_band
string
enum: 24, 5, 5-dedicated, 5-selectable, 6, 6-dedicated, 6-selectable
dhcpd_config_type6
string
enum: local (DHCP Server), none, relay (DHCP Relay)
tunnel_provider_options_zscaler_sub_location
object
14 properties
junos_ip_config
object
Junos IP Config
7 properties
ibeacon_major
integernull
Major number for iBeacon
gateway_wan_probe_override
object
Only if usage==wan
3 properties
gateway_path_preferences_path_target_ips
array
If type==local, if destination IP is to be replaced
ap_zigbee
object
Zigbee AP settings
5 properties
device_event
object
30 properties
3 required
device_type
string
enum: ap, gateway, switch
remote_syslog_user
object
3 properties
dhcpd_config_fixed_binding
object
3 properties
device_switch
object
You can configure portusages and networks settings at the device level, but most of the time it's better use the Site Setting to achieve better consistency and…
63 properties
1 required
acl_tag_specs
array
If type==resource, type==radiusgroup, type==portusage or type==gbpresource. Empty means unrestricted, i.e. any
sw_routing_policy_term_matching_protocol
array
remote_syslog_severity
string
enum: alert, any, critical, emergency, error, info, notice, warning
switch_dhcpd_config_vendor_options
object
If type==server or type6==server. Property key is : , with enterprise number: 1-65535 (https://www.iana.org/assignments/enterprise-numbers/enterprise-numbers)…
snmp_usm_user_encryption_type
string
enum: privacy-3des, privacy-aes128, privacy-des, privacy-none
junos_port_config_speed
string
enum: 100m, 10m, 1g, 2.5g, 5g, 10g, 25g, 40g, 100g,auto
switch_iot_port_alarm_class
string
Alarm class for the switch iot port in. enum: minor, major
tacacs_acct_server
object
4 properties
switch_port_mirroring
object
Property key is the port mirroring instance name. portmirroring can be added under device/site settings. It takes interface and ports as input for ingress, int…
ap_iot_output
object
IoT output AP settings
5 properties
app_probing_custom_app_protocol
string
enum: http, icmp
vrf_config
object
1 property
tacacs_acct_servers
array
ap_iot
object
IoT AP settings
7 properties
zscaler_sub_locations
array
sub-locations can be used for specific uses cases to define different configuration based on the user network
tunnel_config_node_internal_ips
array
Only if provider==zscaler-gre, provider==jse-ipsec, provider==custom-ipsec or provider==custom-gre
ap_port_config_mac_auth_protocol
string
if enablemacauth==true, allows user to select an authentication protocol. enum: eap-md5, eap-peap, pap
switch_dhcpd_config
object
1 property
network
object
Networks are usually subnets that have cross-site significance. networksin Org Settings will got merged into networksin Site Setting. For gateways, they can be…
18 properties
1 required
ap_ip_config
object
IP AP settings
12 properties
idp_profile_matching_attack_name
array
snmp_config_client_lists
array
switch_virtual_chassis_member
object
3 properties
3 required
tunnel_config_auto_provision
object
Auto Provisioning configuration for the tunne. This takes precedence over the primary and secondary nodes.
7 properties
1 required
gateway_wan_probe_override_probe_profile
string
enum: broadband, lte
tacacs_default_role
string
enum: admin, helpdesk, none, read
snmp_config
object
13 properties
dhcpd_config
object
1 property
sw_routing_policy_term_matching
object
zero or more criteria/filter can be specified to match the term, all criteria have to be met
4 properties
dhcpd_config_option_type
string
enum: boolean, hex, int16, int32, ip, string, uint16, uint32
snmp_config_v2c_config
object
4 properties
vlan_id_with_variable
gateway_port_mirroring_port_mirror
object
5 properties
tunnel_config_node
object
Only if provider==zscaler-ipsec, provider==jse-ipsec or provider==custom-ipsec
5 properties
2 required
ble_config_beacon_rate_mode
string
enum: custom, default
network_multicast
object
Whether to enable multicast support (only PIM-sparse mode is supported)
3 properties
ap_ip_config_dns_suffix
array
Required if type==static
ap_search_hostnames
array
List of hostnames detected for the AP
gateway_port_vpn_paths
object
Property key is the VPN name
snmp_config_engine_id
string
response_http429
object
1 property
dns_servers
array
Global dns settings. To keep compatibility, dns settings in ipconfig and oobipconfig will overwrite this setting
id
string
Unique ID of the object instance in the Mist Organization
snmpv3_config_notify_filter_item_content
object
2 properties
ap_mesh_bands
array
List of bands that the mesh should apply to. For relay, the first viable one will be picked. For relay, the first viable one will be picked. enum: 24, 5, 6
protect_re
object
Restrict inbound-traffic to host when enabled, all traffic that is not essential to our operation will be dropped e.g. ntp / dns / traffic to mist will be allo…
5 properties
remote_syslog_cacerts
array
network_internal_access
object
1 property
service_policy_ssl_proxy
object
For SRX-only
2 properties
device_type_switch
string
Device Type. enum: switch
response_http400
object
1 property
dhcpd_config_vendor_option_type
string
enum: boolean, hex, int16, int32, ip, string, uint16, uint32
gateway_wan_type6
string
enum: autoconf, dhcp, static
gw_routing_policy_term_action_add_target_vrfs
array
For SSR, hub decides how VRF routes are leaked on spoke
switch_port_usage_dynamic_rule_equals_any
array
Use equalsany to match any item in a list
dhcpd_config_servers6
array
If type6==relay
snmpv3_config_notify_filter_item
object
2 properties
gateway_port_usage
string
port usage name. enum: hacontrol, hadata, lan, wan
device_ap
object
AP
47 properties
1 required
switch_port_usage_mode
string
mode==dynamic must only be used if the port usage name is dynamic. enum: access, dynamic, inet, trunk
switch_port_usage_networks
array
Only if mode==trunk, the list of network/vlans
network_vpn_access_static_nat
object
Property key may be an External IP Address (i.e. "63.16.0.3"), a CIDR (i.e. "63.16.0.12/20") or a Variable (i.e. "{{myvar}}")
tunnel_config_networks
array
If provider==custom-ipsec or provider==prisma-ipsec, networks reachable via this tunnel
gateway_mgmt_probe_hosts
array
remote_syslog_contents
array
response_http404
object
1 property
next_hop_via
Next-hop IP Address. Can be a single IP address or an array of IP addresses for ECMP (Equal-Cost Multi-Path) load balancing across multiple next-hops.
gateway_ip_config_dns_servers
array
Except for out-ofband interface (vme/em0/fxp0)
ap_uplink_port_config
object
AP Uplink port configuration
2 properties
gateway_port_config_reth_idx
For SRX only and if HA Mode. -1 means it will be managed by the device. Use = 0 values to manage it manually. Ensure no conflicting values are assigned across…
service_policy_ewf
array
switch_port_usage_dynamic_reset_default_when
string
Only if mode==dynamic Control when the DPC port should be changed to the default port usage. enum: linkdown, none (let the DPC port keep at the current port us…
dhcpd_config_dns_suffix
array
If type==local or type6==local - optional, if not defined, system one will be used
gw_routing_policies
object
Property key is the routing policy name
network_vpn_access_destination_nat_property
object
3 properties
network_routed_for_networks
array
For a Network (usually LAN), it can be routable to other networks (e.g. OSPF)
gw_routing_policy_term_matching_protocol
array
dhcpd_config_type
string
enum: local (DHCP Server), none, relay (DHCP Relay)
device_type_default_ap
string
enum: ap, gateway, switch
snmp_vacm_security_to_group_content_item
object
2 properties
radius_acct_port
Radius Auth Port, value from 1 to 65535, default is 1813
switch_vrf_instances
object
Property key is the network name
evpn_config_role
string
enum: access, border, collapsed-core, core, distribution, esilag-access, none
ap_iot_input
object
IoT Input AP settings
3 properties
ap_esl_config
object
8 properties
device_events
array
acl_tag_spec
object
2 properties
radius_coa_port
Radius CoA Port, value from 1 to 65535, default is 3799
search_site_devices_mxtunnel_status
string
enum: down, up
gw_routing_policy_term_matching_vpn_neighbor_mac
array
overlay-facing criteria (used for bgpconfig where via=vpn)
vrrp_config_group
object
2 properties
ap_esl_type
string
note: bleconfig will be ignored if eslconfig is enabled and with native mode. enum: hanshow, imagotag, native, solum
ospf_areas_network
object
Property key is the network name. Networks to participate in an OSPF area
12 properties
count_results
array
tunnel_provider_options
object
3 properties
gw_routing_policy_term_matching_protocol_enum
string
enum: aggregate, bgp, direct, ospf, static (SRX Only)
gateway_port_vpn_path_bfd_profile
string
Only if the VPN type==hubspoke. enum: broadband, lte
radsec_idle_timeout
Radsec Idle Timeout in seconds. Default is 60
acl_tag_subnets
array
If - type==subnet - type==resource (optional. default is any) - type==staticgbp if from matching subnet
gateway_path_type
string
enum: local, tunnel, vpn, wan
switch_ospf_config_area
object
1 property
tunnel_config_probe
object
Only if provider==custom-ipsec
4 properties
tunnel_config_protocol
string
Only if provider==custom-ipsec. enum: gre, ipsec
bgp_config_networks
array
Optional if via==lan. List of networks where we expect BGP neighbor to connect to/from
switch_dhcpd_config_fixed_bindings
object
If type==server or type6==server. Property key is the MAC Address. Format is [0-9a-f]{12} (e.g. "5684dae9ac8b")
acl_tags
object
ACL Tags to identify traffic source or destination. Key name is the tag name
dns_suffix
array
Global dns settings. To keep compatibility, dns settings in ipconfig and oobipconfig will overwrite this setting
response_config_history_search_item_wlans
array
gateway_oob_ip_config_node1
object
For HA Cluster, node1 can have different IP Config
7 properties
config_switch_local_accounts_user_role
string
enum: admin, helpdesk, none, read
response_device_search
object
6 properties
5 required
service_policy_skyatp_http_inspection_profile
string
enum: standard, strict
tacacs_auth_servers
array
tunnel_config_auto_provision_provider
string
enum: jse-ipsec, zscaler-ipsec
response_config_history_search_item_radio
object
2 properties
2 required
switch_virtual_chassis_members
array
List of Virtual Chassis members
ap_client_bridge_auth
object
2 properties
network_vpn_access_destination_nat
object
Property key can be an External IP (i.e. "63.16.0.3"), an External IP:Port (i.e. "63.16.0.3:443"), an External Port (i.e. ":443"), an External CIDR (i.e. "63.1…
gw_routing_policy_term_action_add_community
array
config_device
remote_syslog_server
object
13 properties
ap_port_config_port_auth
string
When doing port auth. enum: dot1x, none
gw_routing_policy_term_matching_vpn_path
array
overlay-facing criteria (used for bgpconfig where via=vpn). ordered-
tunnel_config_node_wan_names
array
switch_ospf_config
object
5 properties
network_vpn_access_config_other_vrfs
array
By default, the routes are only readvertised toward the same vrf on spoke. To allow it to be leaked to other vrfs
acl_policy_actions
array
ACL Policy Actions: - for GBP-based policy, all srctags and dsttags have to be gbp-based - for ACL-based policy, network is required in either the source or de…
config_switch_local_accounts_user
object
2 properties
sw_routing_policy_term
object
3 properties
1 required
gateway_port_config_wan_networks
array
Only if usage==wan. If some networks are connected to this WAN port, it can be added here so policies can be defined
switch_virtual_chassis_member_vc_role
string
Both vcrole master and backup will be matched to routing-engine role in Junos preprovisioned VC config. enum: backup, linecard, master
ap_search_inactive_wired_vlans
array
switch_port_usage_speed
string
Only if mode!=dynamic, Port speed, default is auto to automatically negotiate speed enum: 100m, 10m, 1g, 2.5g, 5g, 10g, 25g, 40g, 100g,auto
switch_ospf_config_areas
object
Property key is the area name. Defines the OSPF areas configured on the switch.
protect_re_allowed_services
array
Optionally, services we'll allow
snmpv3_config_target_params
array
switch_port_usage_mtu
Only if mode!=dynamic media maximum transmission unit (MTU) is the largest data unit that can be forwarded without fragmentation. The default value is 1514.
ap_iot_pullup
string
the type of pull-up the pin uses. enum: external, internal, none
aggregate_routes6
object
Property key is the destination subnet (e.g. "2a02:1234:420a:10c9::/64")
acl_policy_action
object
2 properties
1 required
bgp_config_type
string
Required if via==lan, via==tunnel or via==wan. enum: external, internal
acl_tag_type
string
enum: any: matching anything not identified dynamicgbp: from the gbptag received from RADIUS gbpresource: can only be used in dsttags mac network portusage rad…
tunnel_config_dh_group
string
Only if provider==custom-ipsec. enum: 1 2 (1024-bit) 5 14 (default, 2048-bit) 15 (3072-bit) 16 (4096-bit) 19 (256-bit ECP) 20 (384-bit ECP) 21 (521-bit ECP) 24…
ap_client_bridge_auth_type
string
wpa2-AES/CCMPp is assumed when type==psk. enum: open, psk
gateway_port_dsl_type
string
if wantype==dsl. enum: adsl, vdsl
gateway_mgmt_admin_sshkeys
array
For SSR only, as direct root access is not allowed
bgp_as
BGP AS, value in range 1-4294967294. Can be a Variable (e.g. {{bgpas}} )
radius_config
object
Junos Radius config
9 properties
tunnel_config_ipsec_proposal
object
3 properties
ap_import_json
array
wlan_mist_nac
object
9 properties
tunnel_config_auto_provision_node
object
2 properties
snmp_config_trap_version
string
enum: all, v1, v2
tunnel_config_ike_mode
string
Only if provider==custom-ipsec. enum: aggressive, main
service_policy_ewf_rule
object
4 properties
radius_auth_servers
array
sw_routing_policy_terms
array
at least criteria/filter must be specified to match the term, all criteria have to be met
gateway_port_wan_arp_policer
string
Only when wantype==broadband. enum: default, max, recommended
additional_config_cmds
array
additional CLI commands to append to the generated Junos config. Note: no check is done
remote_syslog_console
object
1 property
service_policy_skyatp_dns_dga_detection
object
2 properties
switch_ospf_config_reference_bandwidth
Reference bandwidth. Integer(100000) or String (10g)
network_internet_access_static_nat_property
object
3 properties
remote_syslog_file_config
object
7 properties
network_vpn_access
object
Property key is the VPN name. Whether this network can be accessed from vpn
snmp_vacm_access_item_prefix_list_item_model
string
enum: any, usm, v1, v2c
snmpv3_config_notify
array
device_type_gateway
string
Device Type. enum: gateway
response_http401
object
1 property
tacacs
object
5 properties
service_policy_skyatp_http_inspection
object
2 properties
switch_port_config_overwrites
object
Property key is the port name or range (e.g. "ge-0/0/0-10"). This can be used to override some attributes of the portusage without having to create a new portu…
remote_syslog_files
array
switch_virtual_chassis
object
Required for preprovisioned Virtual Chassis
2 properties
device_gateway
object
Device gateway
47 properties
1 required
device_type_with_all
string
ap, switch, gateway, router, all, default is ap. Supports comma-separated values for multiple types (e.g., type=switch,gateway)
idp_profile
object
7 properties
dot11_bandwidth6
integer
channel width for the 6GHz band. enum: 0(disabled, response only), 20, 40, 80, 160
snmpv3_config_target_param_mess_process_model
string
enum: v1, v2c, v3
evpn_config
object
EVPN Junos settings
2 properties
gateway_traffic_shaping_class_percentages
array
percentages for different class of traffic: high / medium / low / best-effort. Sum must be equal to 100
radius_acct_servers
array
switch_bgp_config_networks
array
List of network names for BGP configuration. When a network is specified, a BGP group will be added to the VRF that network is part of.
ap_mesh_role
string
enum: base, remote
gateway_port_wan_type
string
Only if usage==wan. enum: broadband, dsl, lte
gw_routing_policy_term_action_exclude_as_path
array
When used as export policy, optional. To exclude certain AS
site_devices_count_distinct
string
enum: hostname, lldpmgmtaddr, lldpportid, lldpsystemdesc, lldpsystemname, mapid, model, mxedgeid, mxtunnelstatus, version
app_probing_custom_apps
array
ble_config_beam_disabled
array
List of AP BLE location beam numbers (1-8) which should be disabled at the AP and not transmit location information (where beam 1 is oriented at the top the AP…
acl_policy_src_tags
array
ACL Policy Source Tags: - for GBP-based policy, all srctags and dsttags have to be gbp-based - for ACL-based policy, network is required in either the source o…
tunnel_config_local_subnets
array
List of Local protected subnet for policy-based IPSec negotiation
snmp_usm_users
array
protect_re_customs
array
switch_vrf_instance
object
7 properties
switch_port_config_overwrite
object
Switch port config
8 properties
antenna_select
string
Antenna Mode for AP which supports selectable antennas. enum: "" (default), external, internal
radius_keywrap_format
string
enum: ascii, hex
protect_re_custom_protocol
string
enum: any, icmp, tcp, udp
const_device_type_ap
string
Device Type. enum: ap
ble_config
object
BLE AP settings
27 properties
const_device_type_gateway
string
Device Type. enum: gateway
tunnel_provider_options_prisma
object
1 property
acl_tag
object
Resource tags (type==resource or type==gbpresource) can only be used in dsttags
9 properties
1 required
devices_gbp_tag
object
2 properties
2 required
app_probing_apps
array
APp-keys from [List Applications](/operations/listApplications)
switch_port_local_usage_dot1x
stringnull
if dot1x is desired, set to dot1x. enum: dot1x
site_id
string
ap_usb_type
string
usb config type. enum: hanshow, imagotag, solum
networks
array
protect_re_custom
object
Custom acls
3 properties
webhook_device_events_event_ev_type
string
(optional) event advisory. enum: notice, warn
gateway_ip_config_dns_suffix
array
Except for out-ofband interface (vme/em0/fxp0)
gw_routing_policy_term_matching_vpn_path_sla
object
3 properties
Specification
The full machine-readable OpenAPI contract behind this narrative.
Source
More from Juniper Mist AI 12
Other APIs Juniper Mist AI publishes across the network.
Juniper Mist WebSocket Streaming API
Juniper Mist Webhooks API
Juniper Mist AI Admins API
Juniper Mist AI Admins Login API
Juniper Mist AI Admins Login - OAuth2 API
Juniper Mist AI Admins Logout API
Juniper Mist AI Admins Lookup API
Juniper Mist AI Admins Recover Password API
Juniper Mist AI Constants Definitions API
Juniper Mist AI Constants Events API
Juniper Mist AI Constants Models API
Juniper Mist AI Installer API
#Sites Devices
Where this information came from
This is an independent, third-party profile of Juniper Mist AI Sites Devices API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.
The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.
Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.
info@apievangelist.com
·
Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and
you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.