Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Juniper Mist AI Sites Synthetic Tests API

Synthetic Tests (Marvis Minis) are a feature of Juniper Networks' Mist platform, designed to proactively identify and resolve network issues before they impact users by simulating user connections and validating network configurations.Here are the key points about Marvis Minis:* Proactive Testing: Marvis Minis perform user connection tests to validate connectivity and application reachability issues on your network. These tests run automatically every hour and can also be initiated manually by an admin user.* Scope and Stress Management: By default, Marvis Minis run on a few APs based on the scope it automatically learns, and it can expand the scope to other APs and switches if necessary, without causing additional stress on network services.* Integration with Mist AI: Data from Marvis Minis is continuously fed back into the Mist AI engine, providing additional insights for AIOps responses. This data is also integrated into Marvis Actions for proactive resolution and validation.* Subscription and Accessibility: Marvis Minis are available at no extra charge with a Marvis VNA subscription and do not require additional hardware or software.

Juniper Mist AI Sites Synthetic Tests API is one of 211 APIs that Juniper Mist AI publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Sites Synthetic Tests. The published artifact set on APIs.io includes an OpenAPI specification and API documentation.

This API exposes 5 operations across 4 paths, and defines 20 schemas. It is described by OpenAPI 3.1.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.

5 operations 4 paths 20 schemas 2 GET3 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.1.0
API Version
2604.1.1
Base URL
https://api.mist.com/api/v1
Authentication
API Key, HTTP Basic, API Key
License
Resource Areas
1

Authentication & Security 3

Juniper Mist AI Sites Synthetic Tests 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 5

Across 4 paths, the API surfaces 5 operations — 2 GET, 3 POST. Each is listed below with its method, path, parameters, and response codes.

Sites Synthetic Tests 5

Synthetic Tests (Marvis Minis) are a feature of Juniper Networks' Mist platform, designed to proactively identify and resolve network issues before they impact users by simulating…

POST
/api/v1/sites/{site_id}/devices/{device_id}/check_radius_server
triggerSiteSwitchRadiusSyntheticTest
startSiteSwitchRadiusSyntheticTest 2 params body → 200400401403404429
GET
/api/v1/sites/{site_id}/devices/{device_id}/synthetic_test
getSiteDeviceSyntheticTest
getSiteDeviceSyntheticTest 2 params → 200400401403404429
POST
/api/v1/sites/{site_id}/devices/{device_id}/synthetic_test
triggerSiteDeviceSyntheticTest
triggerSiteDeviceSyntheticTest 2 params body → 200400401403404429
POST
/api/v1/sites/{site_id}/synthetic_test
triggerSiteSyntheticTest
triggerSiteSyntheticTest 1 param body → 200400401403404429
GET
/api/v1/sites/{site_id}/synthetic_test/search
searchSiteSyntheticTest
searchSiteSyntheticTest 14 params → 200400401403404429

Schemas 20

The contract defines 20 schemas that model the data the API accepts and returns. The most detailed are synthetictest_device (16 properties), synthetictest_info (14 properties), response_synthetictest_search (6 properties), response_synthetictest (3 properties). Each schema is shown below with its type and property counts.

synthetictest_info
object
14 properties
id
string
Unique ID of the object instance in the Mist Organization
synthetictest_device_vlan_id
Required for AP
response_synthetictest_search
object
6 properties 5 required
response_synthetictest
object
3 properties
response_http403
object
1 property
response_synthetictest_search_results
array
synthetictest_radius_server
object
3 properties 2 required
synthetictest_device
object
16 properties 1 required
response_http404
object
1 property
synthetictest
object
1 property
timestamp
number
Epoch (seconds)
synthetictest_device_protocol
string
if type==lanconnectivity. enum: ping, traceroute, ping+traceroute
response_http400
object
1 property
response_http429
object
1 property
websocket_session
object
1 property 1 required
synthetictest_protocol
string
enum: ping, traceroute
synthetictest_type
string
enum: arp, curl, dhcp, dhcp6, dns, lanconnectivity, radius, speedtest
device_type
string
enum: ap, gateway, switch
response_http401
object
1 property

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

mist-ai-sites-synthetic-tests-api-openapi.yml Raw ↑

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