openapi: 3.1.0
info:
contact:
email: tmunzer@juniper.net
name: Thomas Munzer
description: '> Version: **2604.1.1**
>
> Date: **May 13, 2026**
NOTE:
Some important API changes will be introduced. Please make sure to read the
announcements
---
## Additional Documentation
* [Mist Automation Guide](https://www.juniper.net/documentation/us/en/software/mist/automation-integration/index.html)
* [Mist Location SDK](https://www.juniper.net/documentation/us/en/software/mist/location-services/topics/concept/mist-how-get-mist-sdk.html)
* [Mist Product Updates](https://www.juniper.net/documentation/us/en/software/mist/product-updates/)
## Helpful Resources
* [API Sandbox and Exercises](https://api-class.mist.com/)
* [Postman Collection, Runners and Webhook Samples](https://www.postman.com/juniper-mist/workspace/mist-systems-s-public-workspace)
* [Python Script Examples](https://github.com/tmunzer/mist_library)
* [API Demo Apps](https://apps.mist-lab.fr/)
* [Juniper Blog](https://blogs.juniper.net/)
## Mist Web Browser Extension:
* Google Chrome, Microsoft Edge and other Chromium-based browser: [Chrome Web Store](https://chromewebstore.google.com/detail/mist-extension/ejhpdcljeamillfhdihkkmoakanpbplh)
* Firefox: [Firefox Add-ons](https://addons.mozilla.org/en-US/firefox/addon/mist-extension/)
---'
license:
name: MIT
url: https://raw.githubusercontent.com/tmunzer/Mist-OAS3.0/main/LICENSE
title: Mist Admins Constants Definitions API
version: 2604.1.1
x-logo:
altText: Juniper-MistAI
backgroundColor: '#FFFFFF'
url: https://www.mist.com/wp-content/uploads/logo.png
servers:
- description: Mist Global 01
url: https://api.mist.com
- description: Mist Global 02
url: https://api.gc1.mist.com
- description: Mist Global 03
url: https://api.ac2.mist.com
- description: Mist Global 04
url: https://api.gc2.mist.com
- description: Mist Global 05
url: https://api.gc4.mist.com
- description: Mist EMEA 01
url: https://api.eu.mist.com
- description: Mist EMEA 02
url: https://api.gc3.mist.com
- description: Mist EMEA 03
url: https://api.ac6.mist.com
- description: Mist EMEA 04
url: https://api.gc6.mist.com
- description: Mist APAC 01
url: https://api.ac5.mist.com
- description: Mist APAC 02
url: https://api.gc5.mist.com
- description: Mist APAC 03
url: https://api.gc7.mist.com
security:
- apiToken: []
- basicAuth: []
- basicAuth: []
csrfToken: []
tags:
- description: API Calls to retrieve constant values that can be used in different parts of the configuration
name: Constants Definitions
paths:
/api/v1/const/ap_channels:
get:
description: Get List of List of Available channels per country code
operationId: listApChannels
parameters:
- $ref: '#/components/parameters/country_code'
responses:
'200':
$ref: '#/components/responses/ConstApChannels'
'400':
$ref: '#/components/responses/HTTP400'
'401':
$ref: '#/components/responses/HTTP401'
'403':
$ref: '#/components/responses/HTTP403'
'404':
$ref: '#/components/responses/HTTP404'
'429':
$ref: '#/components/responses/HTTP429'
summary: listApChannels
tags:
- Constants Definitions
/api/v1/const/ap_esl_versions:
get:
description: Get Available AP ESL Versions
operationId: listApLEslVersions
responses:
'200':
$ref: '#/components/responses/ConstApEslVersions'
'400':
$ref: '#/components/responses/HTTP400'
'401':
$ref: '#/components/responses/HTTP401'
'403':
$ref: '#/components/responses/HTTP403'
'404':
$ref: '#/components/responses/HTTP404'
'429':
$ref: '#/components/responses/HTTP429'
summary: listApLEslVersions
tags:
- Constants Definitions
/api/v1/const/ap_led_status:
get:
description: Get List of AP LED definition
operationId: listApLedDefinition
responses:
'200':
$ref: '#/components/responses/ConstApLedDefinitions'
'400':
$ref: '#/components/responses/HTTP400'
'401':
$ref: '#/components/responses/HTTP401'
'403':
$ref: '#/components/responses/HTTP403'
'404':
$ref: '#/components/responses/HTTP404'
'429':
$ref: '#/components/responses/HTTP429'
summary: listApLedDefinition
tags:
- Constants Definitions
/api/v1/const/app_categories:
get:
description: Get List of definitions of all the supported Application Categories. The example field contains an example payload as you would receive in the alarm webhook output.
operationId: listAppCategoryDefinitions
responses:
'200':
$ref: '#/components/responses/ConstAppCategoryDefinitions'
'400':
$ref: '#/components/responses/HTTP400'
'401':
$ref: '#/components/responses/HTTP401'
'403':
$ref: '#/components/responses/HTTP403'
'404':
$ref: '#/components/responses/HTTP404'
'429':
$ref: '#/components/responses/HTTP429'
summary: listAppCategoryDefinitions
tags:
- Constants Definitions
/api/v1/const/app_subcategories:
get:
description: Get List of definitions of all the supported Application sub-categories. The example field contains an example payload as you would receive in the alarm webhook output.
operationId: listAppSubCategoryDefinitions
responses:
'200':
$ref: '#/components/responses/ConstAppSubCategoryDefinitions'
'400':
$ref: '#/components/responses/HTTP400'
'401':
$ref: '#/components/responses/HTTP401'
'403':
$ref: '#/components/responses/HTTP403'
'404':
$ref: '#/components/responses/HTTP404'
'429':
$ref: '#/components/responses/HTTP429'
summary: listAppSubCategoryDefinitions
tags:
- Constants Definitions
/api/v1/const/applications:
get:
description: Get List of a list of applications that Juniper-Mist APs recognize
operationId: listApplications
responses:
'200':
$ref: '#/components/responses/ConstApplications'
'400':
$ref: '#/components/responses/HTTP400'
'401':
$ref: '#/components/responses/HTTP401'
'403':
$ref: '#/components/responses/HTTP403'
'404':
$ref: '#/components/responses/HTTP404'
'429':
$ref: '#/components/responses/HTTP429'
summary: listApplications
tags:
- Constants Definitions
/api/v1/const/countries:
get:
description: Get List of available Country Codes
operationId: listCountryCodes
parameters:
- description: Will include more country codes if true
in: query
name: extend
schema:
default: false
type: boolean
responses:
'200':
$ref: '#/components/responses/ConstCountries'
'400':
$ref: '#/components/responses/HTTP400'
'401':
$ref: '#/components/responses/HTTP401'
'403':
$ref: '#/components/responses/HTTP403'
'404':
$ref: '#/components/responses/HTTP404'
'429':
$ref: '#/components/responses/HTTP429'
summary: listCountryCodes
tags:
- Constants Definitions
/api/v1/const/fingerprint_types:
get:
description: 'Get List of supported fingerprint attribute values
* family
* model
* mfg
* os_type
This information can be used in the [Mist NAC Rules]($h/Orgs%20NAC%20Rules/_overview) `matching` attribute.'
operationId: listFingerprintTypes
responses:
'200':
$ref: '#/components/responses/ConstFingerprintTypes'
'400':
$ref: '#/components/responses/HTTP400'
'401':
$ref: '#/components/responses/HTTP401'
'403':
$ref: '#/components/responses/HTTP403'
'404':
$ref: '#/components/responses/HTTP404'
'429':
$ref: '#/components/responses/HTTP429'
summary: listFingerprintTypes
tags:
- Constants Definitions
/api/v1/const/gateway_applications:
get:
description: Get the full list of applications that we recognize
operationId: listGatewayApplications
responses:
'200':
$ref: '#/components/responses/ConstGatewayApplications'
'400':
$ref: '#/components/responses/HTTP400'
'401':
$ref: '#/components/responses/HTTP401'
'403':
$ref: '#/components/responses/HTTP403'
'404':
$ref: '#/components/responses/HTTP404'
'429':
$ref: '#/components/responses/HTTP429'
summary: listGatewayApplications
tags:
- Constants Definitions
/api/v1/const/insight_metrics:
get:
description: List Insight Metrics
operationId: listInsightMetrics
responses:
'200':
$ref: '#/components/responses/ConstInsightMetrics'
'400':
$ref: '#/components/responses/HTTP400'
'401':
$ref: '#/components/responses/HTTP401'
'403':
$ref: '#/components/responses/HTTP403'
'404':
$ref: '#/components/responses/HTTP404'
'429':
$ref: '#/components/responses/HTTP429'
summary: listInsightMetrics
tags:
- Constants Definitions
/api/v1/const/languages:
get:
description: Get List of Languages
operationId: listSiteLanguages
responses:
'200':
$ref: '#/components/responses/ConstLanguages'
'400':
$ref: '#/components/responses/HTTP400'
'401':
$ref: '#/components/responses/HTTP401'
'403':
$ref: '#/components/responses/HTTP403'
'404':
$ref: '#/components/responses/HTTP404'
'429':
$ref: '#/components/responses/HTTP429'
summary: listSiteLanguages
tags:
- Constants Definitions
/api/v1/const/license_types:
get:
description: Get License Types
operationId: listLicenseTypes
responses:
'200':
$ref: '#/components/responses/ConstLicenseTypes'
'400':
$ref: '#/components/responses/HTTP400'
'401':
$ref: '#/components/responses/HTTP401'
'403':
$ref: '#/components/responses/HTTP403'
'404':
$ref: '#/components/responses/HTTP404'
'429':
$ref: '#/components/responses/HTTP429'
summary: listLicenseTypes
tags:
- Constants Definitions
/api/v1/const/marvisclient_versions:
get:
description: Get List of the available Marvis Client Versions.
operationId: listMarvisClientVersions
responses:
'200':
$ref: '#/components/responses/ConstMarvisClientVersions'
'400':
$ref: '#/components/responses/HTTP400'
'401':
$ref: '#/components/responses/HTTP401'
'403':
$ref: '#/components/responses/HTTP403'
'404':
$ref: '#/components/responses/HTTP404'
'429':
$ref: '#/components/responses/HTTP429'
summary: listMarvisClientVersions
tags:
- Constants Definitions
/api/v1/const/states:
get:
description: Get List of ISO States based on country code
operationId: listStates
parameters:
- description: Country code, in [two-character](/#operations/listCountryCodes)
in: query
name: country_code
required: true
schema:
examples:
- US
type: string
responses:
'200':
$ref: '#/components/responses/ConstStates'
'400':
$ref: '#/components/responses/HTTP400'
'401':
$ref: '#/components/responses/HTTP401'
'403':
$ref: '#/components/responses/HTTP403'
'404':
$ref: '#/components/responses/HTTP404'
'429':
$ref: '#/components/responses/HTTP429'
summary: listStates
tags:
- Constants Definitions
/api/v1/const/traffic_types:
get:
description: Get List of identified traffic
operationId: listTrafficTypes
responses:
'200':
$ref: '#/components/responses/ConstTrafficTypes'
'400':
$ref: '#/components/responses/HTTP400'
'401':
$ref: '#/components/responses/HTTP401'
'403':
$ref: '#/components/responses/HTTP403'
'404':
$ref: '#/components/responses/HTTP404'
'429':
$ref: '#/components/responses/HTTP429'
summary: listTrafficTypes
tags:
- Constants Definitions
/api/v1/const/webhook_topics:
get:
description: Get List of the available Webhook Topics.
operationId: listWebhookTopics
responses:
'200':
$ref: '#/components/responses/ConstWebhookTopics'
'400':
$ref: '#/components/responses/HTTP400'
'401':
$ref: '#/components/responses/HTTP401'
'403':
$ref: '#/components/responses/HTTP403'
'404':
$ref: '#/components/responses/HTTP404'
'429':
$ref: '#/components/responses/HTTP429'
summary: listWebhookTopics
tags:
- Constants Definitions
components:
schemas:
const_insight_metrics_property_scope:
description: 'enum: `ap`, `client`, `device`, `gateway`, `map`, `msp`, `mxcluster`, `mxedge`, `org`, `otherdevice`, `rssizone`, `sdkclient`, `site`, `switch`, `wlan`, `zone`'
enum:
- ap
- client
- device
- gateway
- map
- msp
- mxcluster
- mxedge
- org
- otherdevice
- rssizone
- sdkclient
- site
- switch
- wlan
- zone
type: string
const_application_definition:
additionalProperties: false
properties:
app_id:
type: boolean
app_image_url:
examples:
- '""'
type: string
app_probe:
type: boolean
category:
examples:
- FileSharing
type: string
group:
examples:
- File Sharing
type: string
key:
examples:
- dropbox
type: string
name:
examples:
- Dropbox
type: string
signature_based:
type: boolean
ssr_app_id:
type: boolean
type: object
strings:
items:
type: string
type: array
uniqueItems: true
const_app_category_definition_filters:
additionalProperties: false
examples:
- srx:
- Enhanced_Images_Media
- Enhanced_Web_Images
- Enhanced_Image_Servers
properties:
srx:
$ref: '#/components/schemas/strings'
ssr:
$ref: '#/components/schemas/strings'
type: object
const_traffic_types:
items:
$ref: '#/components/schemas/const_traffic_type'
type: array
const_ap_esl_version:
additionalProperties: false
properties:
esl_version:
examples:
- 2.5.1
readOnly: true
type: string
model:
examples:
- AP34
readOnly: true
type: string
type: object
const_insight_metrics_property_report_durations:
additionalProperties:
$ref: '#/components/schemas/const_insight_metrics_property_report_duration'
description: Property key is the duration (e.g. 1d, 1w, ...)
type: object
const_languages:
items:
$ref: '#/components/schemas/const_language'
type: array
const_country:
additionalProperties: false
properties:
alpha2:
description: Country code, in two-character
examples:
- FR
type: string
certified:
examples:
- true
type: boolean
name:
examples:
- France
type: string
numeric:
description: Country code, ISO 3166-1 numeric
examples:
- 250
type: number
required:
- alpha2
- numeric
- name
- certified
type: object
const_app_category_definition_includes:
description: List of other App Categories contained by this one
items:
type: string
type: array
ap_channel_band5_channels:
additionalProperties:
$ref: '#/components/schemas/ap_channel_band5_channel'
description: Property key is the channel width
examples:
- '20':
- 36
- 40
- 44
- 48
- 52
- 56
- 60
- 64
- 100
- 104
- 108
- 112
- 116
- 120
- 124
- 128
- 132
- 136
- 140
- 144
- 149
- 153
- 157
- 161
- 165
'40':
- 36
- 40
- 44
- 48
- 52
- 56
- 60
- 64
- 100
- 104
- 108
- 112
- 116
- 120
- 124
- 128
- 132
- 136
- 140
- 144
- 149
- 153
- 157
- 161
'80':
- 36
- 40
- 44
- 48
- 52
- 56
- 60
- 64
- 100
- 104
- 108
- 112
- 116
- 120
- 124
- 128
- 132
- 136
- 140
- 144
- 149
- 153
- 157
- 161
dfs:
- 52
- 56
- 60
- 64
- 100
- 104
- 108
- 112
- 116
- 120
- 124
- 128
- 132
- 136
- 140
- 144
outdoor:
- 36
- 40
- 44
- 48
- 52
- 56
- 60
- 64
- 100
- 104
- 108
- 112
- 116
- 120
- 124
- 128
- 132
- 136
- 140
- 144
- 149
- 153
- 157
- 161
- 165
type: object
const_ap_leds:
items:
$ref: '#/components/schemas/const_ap_led'
type: array
const_insight_metrics_property_keys:
additionalProperties: true
type: object
const_insight_metrics_property_param:
additionalProperties: false
properties:
required:
type: boolean
type: object
const_insight_metrics_property_params:
additionalProperties:
$ref: '#/components/schemas/const_insight_metrics_property_param'
description: Property key is the parameter name
type: object
response_http401:
additionalProperties: false
properties:
detail:
examples:
- Authentication credentials were not provided.
type: string
type: object
const_insight_metrics_property_examples_object:
additionalProperties:
$ref: '#/components/schemas/const_insight_metrics_property_examples'
description: Object containing named fields, each with array of example values
type: object
const_license_type_includes:
examples:
- - sub_ex12a
- sub_ex12p
items:
type: string
type: array
ap_channel_band6_channel:
items:
examples:
- 1
type: integer
type: array
const_license_type:
additionalProperties: false
properties:
description:
examples:
- Wired Assurance 12
type: string
includes:
$ref: '#/components/schemas/const_license_type_includes'
key:
examples:
- sub_ex12
type: string
name:
examples:
- SUB-EX12
type: string
type: object
const_marvis_client_versions:
items:
$ref: '#/components/schemas/const_marvis_client_version'
type: array
const_webhook_topics:
items:
$ref: '#/components/schemas/const_webhook_topic'
type: array
ap_channel_band5_channel:
items:
examples:
- 36
type: integer
type: array
const_license_types:
items:
$ref: '#/components/schemas/const_license_type'
type: array
const_app_subcategory_definitions:
items:
$ref: '#/components/schemas/const_app_subcategory_definition'
type: array
const_app_subcategory_definition:
additionalProperties: false
properties:
display:
description: Description of the app subcategory
examples:
- Office Document
type: string
key:
description: Key name of the app subcategory
examples:
- Office_Documents
type: string
traffic_type:
description: Type of traffic (QoS) of the app subcategory
examples:
- Images
type: string
required:
- key
- display
- traffic_type
type: object
ap_channel_band24_channels:
additionalProperties:
$ref: '#/components/schemas/ap_channel_band24_channel'
description: Property key is the channel width
examples:
- '20':
- 1
- 2
- 3
- 4
- 5
- 6
- 7
- 8
- 9
- 10
- 11
'40':
- 1
- 2
- 3
- 4
- 5
- 6
- 7
- 8
- 9
- 10
- 11
type: object
const_gateway_applications_definition:
additionalProperties: false
properties:
app_id:
examples:
- true
type: boolean
key:
examples:
- 4shared
type: string
name:
examples:
- 4shared
type: string
ssr_app_id:
examples:
- true
type: boolean
type: object
const_insight_metrics_property_example_any_of:
anyOf:
- $ref: '#/components/schemas/const_insight_metrics_property_examples'
- $ref: '#/components/schemas/const_insight_metrics_property_examples_object'
const_webhook_topic:
additionalProperties: false
properties:
allows_single_event_per_message:
description: supports single event per message results
type: boolean
for_org:
description: Can be used in org webhooks, optional
type: boolean
has_delivery_results:
description: Supports webhook delivery results /api/v1/:scope/:scope_id/webhooks/:webhook_id/events/search
type: boolean
internal:
description: Internal topic (not selectable in site/org webhooks)
type: boolean
key:
description: Webhook topic name
examples:
- alarms
type: string
type: object
const_traffic_type:
additionalProperties: false
properties:
display:
examples:
- VoIP Video
type: string
dscp:
examples:
- 32
type: integer
failover_policy:
examples:
- non_revertible
type: string
max_jitter:
examples:
- 250
type: integer
max_latency:
examples:
- 1500
type: integer
max_loss:
examples:
- 35
type: integer
name:
examples:
- voip_video
type: string
traffic_class:
examples:
- medium
type: string
type: object
const_app_category_definition:
additionalProperties: false
properties:
display:
description: Description of the app category
examples:
- Images
type: string
filters:
$ref: '#/components/schemas/const_app_category_definition_filters'
includes:
$ref: '#/components/schemas/const_app_category_definition_includes'
key:
description: Key name of the app category
examples:
- Images
type: string
required:
- key
- display
type: object
const_insight_metrics_property_scopes:
items:
$ref: '#/components/schemas/const_insight_metrics_property_scope'
type: array
const_ap_esl_versions:
items:
$ref: '#/components/schemas/const_ap_esl_version'
type: array
const_insight_metrics_property_intervals:
additionalProperties:
$ref: '#/components/schemas/const_insight_metrics_property_interval'
description: Property key is the interval (e.g. 10m, 1h, ...)
type: object
const_state:
additionalProperties: false
properties:
iso_code:
examples:
- AK
type: string
name:
examples:
- Alaska
type: string
type: object
const_app_category_definitions:
items:
$ref: '#/components/schemas/const_app_category_definition'
type: array
const_insight_metrics_property_values:
additionalProperties: true
type: object
response_http429:
additionalProperties: false
properties:
detail:
examples:
- Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
type: string
type: object
const_application_definitions:
items:
$ref: '#/components/schemas/const_application_definition'
type: array
const_states:
items:
$ref: '#/components/schemas/const_state'
type: array
ap_channel_band24_channel:
items:
examples:
- 1
type: integer
type: array
const_insight_metrics_property_examples:
items:
$ref: '#/components/schemas/const_insight_metrics_property_example'
type: array
response_http403:
additionalProperties: false
properties:
detail:
examples:
- You do not have permission to perform this action.
type: string
type: object
response_http404:
additionalProperties: false
properties:
id:
type: string
type: object
const_ap_led:
additionalProperties: false
properties:
code:
examples:
- '01'
type: string
description:
examples:
- LED not working
type: string
key:
examples:
- LED_FAILURE
type: string
name:
examples:
- LED Failure
type: string
required:
- code
- key
- name
- description
type: object
const_countries:
items:
$ref: '#/components/schemas/const_country'
type: array
response_http400:
additionalProperties: false
properties:
detail:
examples:
- 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
type: string
type: object
const_fingerprint_types:
additionalProperties: false
properties:
family:
$ref: '#/components/schemas/strings'
mfg:
$ref: '#/components/schemas/strings'
model:
$ref: '#/components/schemas/strings'
os:
$ref: '#/components/schemas/strings'
type: object
ap_channel_band6_channels:
additionalProperties:
$ref: '#/components/schemas/ap_channel_band6_channel'
description: Property key is the channel width
examples:
- '160':
- 1
- 5
- 9
- 13
- 17
- 21
- 25
- 29
- 33
- 37
- 41
- 45
- 49
- 53
- 57
- 61
- 65
- 69
- 73
- 77
- 81
- 85
- 89
- 93
- 97
- 101
- 105
- 109
- 113
- 117
- 121
- 125
- 129
- 133
- 137
- 141
- 145
- 149
- 153
- 157
- 161
- 165
- 169
- 173
- 177
- 181
- 185
- 189
- 193
- 197
- 201
- 205
- 209
- 213
- 217
- 221
'20':
- 1
- 5
- 9
- 13
- 17
- 21
- 25
- 29
- 33
- 37
- 41
- 45
- 49
- 53
- 57
- 61
- 65
- 69
- 73
- 77
- 81
- 85
- 89
- 93
- 97
- 101
- 105
- 109
- 113
- 117
- 121
- 125
- 129
- 133
- 137
- 141
- 145
- 149
- 153
- 157
- 161
- 165
- 169
- 173
- 177
- 181
- 185
- 189
- 193
- 197
- 201
- 205
- 209
- 213
- 217
- 221
- 225
- 229
- 233
'40':
- 1
- 5
- 9
- 13
- 17
- 21
- 25
- 29
- 33
- 37
- 41
- 45
- 49
- 53
- 57
- 61
- 65
- 69
- 73
- 77
- 81
- 85
- 89
- 93
- 97
- 101
- 105
- 109
- 113
- 117
- 121
- 125
- 129
- 133
- 137
- 141
- 145
- 149
- 153
- 157
- 161
- 165
- 169
- 173
- 177
- 181
- 185
- 189
- 193
- 197
- 201
- 205
- 209
- 213
- 217
- 221
- 225
- 229
'80':
- 1
- 5
- 9
- 13
- 17
- 21
- 25
- 29
- 33
- 37
- 41
- 45
- 49
- 53
- 57
- 61
- 65
- 69
- 73
- 77
- 81
- 85
- 89
- 93
- 97
- 101
- 105
- 109
- 113
- 117
- 121
- 125
- 129
- 133
- 137
- 141
- 145
- 149
- 153
- 157
- 161
- 165
- 169
- 173
- 177
- 181
- 185
- 189
- 193
- 197
- 201
- 205
- 209
- 213
- 217
- 221
psc:
- 5
- 21
- 37
- 53
- 69
- 85
- 101
- 117
- 133
- 149
- 165
- 181
- 197
- 213
- 229
type: object
const_marvis_client_version:
additionalProperties: false
properties:
label:
examples:
- default
type: string
notes:
type: string
os:
description: Client OS
examples:
- windows
type: string
url:
description: Client download url
examples:
- https://mobile.mist.com/installers/marvisclient/...
type: string
version:
description: Client version
examples:
- 0.100.29
type: string
type: object
const_insight_metrics_property_report_duration:
additionalProperties: false
properties:
duration:
type: integer
interval:
type: integer
type: object
const_insight_metrics_property_example:
anyOf:
- type: integer
- type: number
- type: string
- type: boolean
- type: 'null'
- additionalProperties: true
type: object
const_gateway_applications_definitions:
items:
$ref: '#/components/schemas/const_gateway_applications_definition'
type: array
const_insight_metrics_property:
additionalProperties: false
properties:
ctype:
$ref: '#/components/schemas/strings'
description:
type: string
example:
$ref: '#/components/schemas/const_insight_metrics_property_example_any_of'
intervals:
$ref: '#/components/schemas/const_insight_metrics_property_intervals'
keys:
$ref: '#/components/schemas/const_insight_metrics_property_keys'
params:
$ref: '#/components/schemas/const_insight_metrics_property_params'
report_durations:
$ref: '#/components/schemas/const_insight_metrics_property_report_durations'
report_scopes:
$ref: '#/components/schemas/strings'
scopes:
$ref: '#/components/schemas/const_insight_metrics_property_scopes'
sle_baselined:
type: boolean
sle_classifiers:
$ref: '#/components/schemas/strings'
type:
type: string
unit:
type: string
values:
$ref: '#/components/schemas/const_insight_metrics_property_values'
type: object
const_insight_metrics_property_interval:
additionalProperties: false
properties:
interval:
type: integer
max_age:
type: integer
type: object
const_language:
additionalProperties: false
properties:
display:
examples:
- English (US)
type: string
display_native:
examples:
- English (US)
type: string
key:
examples:
- en-US
type: string
required:
- display
- display_native
- key
type: object
const_insight_metrics:
additionalProperties:
$ref: '#/components/schemas/const_insight_metrics_property'
description: Property key is the metric name
type: object
const_ap_channel:
additionalProperties: false
properties:
band24_40mhz_allowed:
examples:
- true
type: boolean
band24_channels:
$ref: '#/components/schemas/ap_channel_band24_channels'
band24_enabled:
examples:
- true
type: boolean
band5_channels:
$ref: '#/components/schemas/ap_channel_band5_channels'
band5_enabled:
examples:
- true
type: boolean
band6_channels:
$ref: '#/components/schemas/ap_channel_band6_channels'
band6_enabled:
examples:
- true
type: boolean
certified:
examples:
- true
type: boolean
code:
description: Country code, ISO 3166-1 numeric
examples:
- 840
type: integer
dfs_ok:
examples:
- true
type: boolean
key:
description: Country code, in two-character
examples:
- US
type: string
name:
examples:
- United States
type: string
uses:
examples:
- US_FCC
type: string
type: object
examples:
ConstStatesExample:
value:
- iso_code: AK
name: Alaska
- iso_code: AL
name: Alabama
- iso_code: AS
name: American Samoa
- iso_code: AZ
name: Arizona
- iso_code: CA
name: California
HTTP403Example:
value:
detail: You do not have permission to perform this action.
ConstMarvisClientVersionsExample:
value:
- label: default
notes: ''
os: android
url: https://mobile.mist.com/installers/marvisclient/android/1.1.9/marvisclient-installer.apk
version: 1.1.9
- label: default
notes: ''
os: macos
url: https://mobile.mist.com/installers/marvisclient/macos/0.100.29/marvisclient-installer.dmg
version: 0.100.29
- label: default
notes: ''
os: windows
url: https://mobile.mist.com/installers/marvisclient/windows/0.100.26/marvisclient-installer.zip
version: 0.100.26
ConstApplicationsExample:
value:
- app_id: true
app_image_url: ''
app_probe: true
category: FileSharing
group: File Sharing
key: dropbox
name: Dropbox
signature_based: true
ssr_app_id: true
ConstApLedDefinitionsExample:
value:
- code: '01'
description: LED not working
key: LED_FAILURE
name: LED Failure
ConstLanguagesExample:
value:
- display: English (US)
display_native: English (US)
key: en-US
ConstCountriesExample:
value:
- alpha2: FR
certified: true
name: France
numeric: 250
ConstAppSubCategoryDefinitionsExample:
value:
- display: Office Documents
key: Office_Documents
traffic_type: data_interactive
ConstWebhookTopicsExample:
value:
- for_org: true
has_delivery_results: true
key: alarms
- key: asset-raw-rssi
- for_org: true
has_delivery_results: true
key: audits
- for_org: true
key: client-info
- for_org: true
key: client-join
- key: client-latency
- for_org: true
key: client-sessions
- allows_single_event_per_message: true
for_org: true
key: device-events
- for_org: true
has_delivery_results: true
key: device-updowns
- for_org: true
key: minis-reachability
ConstGatewayApplicationsExample:
value:
- app_id: true
key: 4shared
name: 4shared
ssr_app_id: true
ConstInsightMetricsExample:
value:
bytes:
description: Aggregated bytes over time
example:
- 185
- 197
- 250
intervals:
10m:
interval: 600
max_age: 86400
1h:
interval: 3600
max_age: 1209600
report_durations:
1d:
duration: 86400
interval: 3600
1w:
duration: 604800
interval: 3600
report_scopes:
- site
- org
scopes:
- site
- ap
- client
type: timeseries
unit: byte
num_clients:
description: Number of client over time
example:
- 18
- null
- 15
intervals:
10m:
interval: 600
max_age: 86400
1h:
interval: 3600
max_age: 1209600
report_durations:
1d:
duration: 86400
interval: 3600
1w:
duration: 604800
interval: 3600
report_scopes:
- site
- org
scopes:
- site
- ap
- device
type: timeseries
unit: ''
ConstApChannelsExample:
value:
band24_40mhz_allowed: true
band24_channels:
'20':
- 1
- 2
- 3
- 4
- 5
- 6
- 7
- 8
- 9
- 10
- 11
'40':
- 1
- 2
- 3
- 4
- 5
- 6
- 7
- 8
- 9
- 10
- 11
band24_enabled: true
band5_channels:
'20':
- 36
- 40
- 44
- 48
- 52
- 56
- 60
- 64
- 100
- 104
- 108
- 112
- 116
- 120
- 124
- 128
- 132
- 136
- 140
- 144
- 149
- 153
- 157
- 161
- 165
'40':
- 36
- 40
- 44
- 48
- 52
- 56
- 60
- 64
- 100
- 104
- 108
- 112
- 116
- 120
- 124
- 128
- 132
- 136
- 140
- 144
- 149
- 153
- 157
- 161
'80':
- 36
- 40
- 44
- 48
- 52
- 56
- 60
- 64
- 100
- 104
- 108
- 112
- 116
- 120
- 124
- 128
- 132
- 136
- 140
- 144
- 149
- 153
- 157
- 161
dfs:
- 52
- 56
- 60
- 64
- 100
- 104
- 108
- 112
- 116
- 120
- 124
- 128
- 132
- 136
- 140
- 144
outdoor:
- 36
- 40
- 44
- 48
- 52
- 56
- 60
- 64
- 100
- 104
- 108
- 112
- 116
- 120
- 124
- 128
- 132
- 136
- 140
- 144
- 149
- 153
- 157
- 161
- 165
band5_enabled: true
band6_channels:
'160':
- 1
- 5
- 9
- 13
- 17
- 21
- 25
- 29
- 33
- 37
- 41
- 45
- 49
- 53
- 57
- 61
- 65
- 69
- 73
- 77
- 81
- 85
- 89
- 93
- 97
- 101
- 105
- 109
- 113
- 117
- 121
- 125
- 129
- 133
- 137
- 141
- 145
- 149
- 153
- 157
- 161
- 165
- 169
- 173
- 177
- 181
- 185
- 189
- 193
- 197
- 201
- 205
- 209
- 213
- 217
- 221
'20':
- 1
- 5
- 9
- 13
- 17
- 21
- 25
- 29
- 33
- 37
- 41
- 45
- 49
- 53
- 57
- 61
- 65
- 69
- 73
- 77
- 81
- 85
- 89
- 93
- 97
- 101
- 105
- 109
- 113
- 117
- 121
- 125
- 129
- 133
- 137
- 141
- 145
- 149
- 153
- 157
- 161
- 165
- 169
- 173
- 177
- 181
- 185
- 189
- 193
- 197
- 201
- 205
- 209
- 213
- 217
- 221
- 225
- 229
- 233
'40':
- 1
- 5
- 9
- 13
- 17
- 21
- 25
- 29
- 33
- 37
- 41
- 45
- 49
- 53
- 57
- 61
- 65
- 69
- 73
- 77
- 81
- 85
- 89
- 93
- 97
- 101
- 105
- 109
- 113
- 117
- 121
- 125
- 129
- 133
- 137
- 141
- 145
- 149
- 153
- 157
- 161
- 165
- 169
- 173
- 177
- 181
- 185
- 189
- 193
- 197
- 201
- 205
- 209
- 213
- 217
- 221
- 225
- 229
'80':
- 1
- 5
- 9
- 13
- 17
- 21
- 25
- 29
- 33
- 37
- 41
- 45
- 49
- 53
- 57
- 61
- 65
- 69
- 73
- 77
- 81
- 85
- 89
- 93
- 97
- 101
- 105
- 109
- 113
- 117
- 121
- 125
- 129
- 133
- 137
- 141
- 145
- 149
- 153
- 157
- 161
- 165
- 169
- 173
- 177
- 181
- 185
- 189
- 193
- 197
- 201
- 205
- 209
- 213
- 217
- 221
psc:
- 5
- 21
- 37
- 53
- 69
- 85
- 101
- 117
- 133
- 149
- 165
- 181
- 197
- 213
- 229
band6_enabled: true
certified: true
code: 840
dfs_ok: true
key: US
name: United States
uses: US_FCC
HTTP429Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
ConstFingerprintTypesExample:
value:
family:
- 2Wire Router
- 3Com Switches
- ACTi Corporation Network Camera
- APC Video Equipment
- APC-Schneider UPS
- Aastra VoIP
- Acer
- Actiontec Wireless Router
- Aerohive Access Point
- Alcatel
- Alcatel VoIP
- Amazon Echo
mfg:
- 100fio Networks Technology llc
- 10NET COMMUNICATIONS/DCA
- 11wave Technonlogy Co.,Ltd
- 12Sided Technology, LLC
- 1Net Corporation
- 1Verge Internet Technology (Beijing) Co., Ltd.
model:
- 10T Lite
- 10T Pro
- 10th Gen
- 11 Lite
- 11 Pro
- 11 Pro Max
os:
- Android
- Apple OS
- Asha Platform OS
ConstLicenseTypesExample:
value:
- description: Wired Assurance 12
includes:
- sub_ex12a
- sub_ex12p
key: sub_ex12
name: SUB-EX12
ConstApEslVersionsExample:
value:
- esl_version: 2.5.1
model: AP34
- esl_version: 2.5.0
model: AP43
ConstTrafficTypesExample:
value:
- display: VoIP Video
dscp: 32
failover_policy: non_revertible
max_jitter: 250
max_latency: 1500
max_loss: 35
name: voip_video
traffic_class: medium
HTTP400Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
HTTP401Example:
value:
detail: Authentication credentials were not provided.
ConstAppCategoryDefinitionsExample:
value:
- display: Images
filters:
srx:
- Enhanced_Images_Media
- Enhanced_Web_Images
- Enhanced_Image_Servers
key: Images
- display: Standard
includes:
- Adult
- FileSharing
- Games
- Images
- Malware
- NewsAndReference
- Recreation
- Religion
- Security
- Sports
- Technology
- Violence
key: Standard
responses:
ConstWebhookTopics:
content:
application/json:
examples:
Example:
$ref: '#/components/examples/ConstWebhookTopicsExample'
schema:
$ref: '#/components/schemas/const_webhook_topics'
application/vnd.api+json:
examples:
Example:
$ref: '#/components/examples/ConstWebhookTopicsExample'
schema:
$ref: '#/components/schemas/const_webhook_topics'
description: List of Webhook Topics
HTTP403:
content:
application/json:
examples:
Example:
$ref: '#/components/examples/HTTP403Example'
schema:
$ref: '#/components/schemas/response_http403'
application/vnd.api+json:
examples:
Example:
$ref: '#/components/examples/HTTP403Example'
schema:
$ref: '#/components/schemas/response_http403'
description: Permission Denied
ConstApLedDefinitions:
content:
application/json:
examples:
Example:
$ref: '#/components/examples/ConstApLedDefinitionsExample'
schema:
$ref: '#/components/schemas/const_ap_leds'
application/vnd.api+json:
examples:
Example:
$ref: '#/components/examples/ConstApLedDefinitionsExample'
schema:
$ref: '#/components/schemas/const_ap_leds'
description: List of AP Led Status
ConstMarvisClientVersions:
content:
application/json:
examples:
Example:
$ref: '#/components/examples/ConstMarvisClientVersionsExample'
schema:
$ref: '#/components/schemas/const_marvis_client_versions'
application/vnd.api+json:
examples:
Example:
$ref: '#/components/examples/ConstMarvisClientVersionsExample'
schema:
$ref: '#/components/schemas/const_marvis_client_versions'
description: List of Webhook Topics
HTTP401:
content:
application/json:
examples:
Example:
$ref: '#/components/examples/HTTP401Example'
schema:
$ref: '#/components/schemas/response_http401'
application/vnd.api+json:
examples:
Example:
$ref: '#/components/examples/HTTP401Example'
schema:
$ref: '#/components/schemas/response_http401'
description: Unauthorized
ConstAppSubCategoryDefinitions:
content:
application/json:
examples:
Example:
$ref: '#/components/examples/ConstAppSubCategoryDefinitionsExample'
schema:
$ref: '#/components/schemas/const_app_subcategory_definitions'
application/vnd.api+json:
examples:
Example:
$ref: '#/components/examples/ConstAppSubCategoryDefinitionsExample'
schema:
$ref: '#/components/schemas/const_app_subcategory_definitions'
description: List of Application Sub-categories Definitions
ConstApChannels:
content:
application/json:
examples:
Example:
$ref: '#/components/examples/ConstApChannelsExample'
schema:
$ref: '#/components/schemas/const_ap_channel'
application/vnd.api+json:
examples:
Example:
$ref: '#/components/examples/ConstApChannelsExample'
schema:
$ref: '#/components/schemas/const_ap_channel'
description: AP Channels
ConstAppCategoryDefinitions:
content:
application/json:
examples:
Example:
$ref: '#/components/examples/ConstAppCategoryDefinitionsExample'
schema:
$ref: '#/components/schemas/const_app_category_definitions'
application/vnd.api+json:
examples:
Example:
$ref: '#/components/examples/ConstAppCategoryDefinitionsExample'
schema:
$ref: '#/components/schemas/const_app_category_definitions'
description: List of Application Categories Definitions
ConstFingerprintTypes:
content:
application/json:
examples:
Example:
$ref: '#/components/examples/ConstFingerprintTypesExample'
schema:
$ref: '#/components/schemas/const_fingerprint_types'
application/vnd.api+json:
examples:
Example:
$ref: '#/components/examples/ConstFingerprintTypesExample'
schema:
$ref: '#/components/schemas/const_fingerprint_types'
description: List of Fingerprint Types
ConstApplications:
content:
application/json:
examples:
Example:
$ref: '#/components/examples/ConstApplicationsExample'
schema:
$ref: '#/components/schemas/const_application_definitions'
application/vnd.api+json:
examples:
Example:
$ref: '#/components/examples/ConstApplicationsExample'
schema:
$ref: '#/components/schemas/const_application_definitions'
description: List of Applications
HTTP404:
content:
application/json:
schema:
$ref: '#/components/schemas/response_http404'
application/vnd.api+json:
schema:
$ref: '#/components/schemas/response_http404'
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
ConstStates:
content:
application/json:
examples:
Example:
$ref: '#/components/examples/ConstStatesExample'
schema:
$ref: '#/components/schemas/const_states'
application/vnd.api+json:
examples:
Example:
$ref: '#/components/examples/ConstStatesExample'
schema:
$ref: '#/components/schemas/const_states'
description: List of Countries
ConstApEslVersions:
content:
application/json:
examples:
Example:
$ref: '#/components/examples/ConstApEslVersionsExample'
schema:
$ref: '#/components/schemas/const_ap_esl_versions'
application/vnd.api+json:
examples:
Example:
$ref: '#/components/examples/ConstApEslVersionsExample'
schema:
$ref: '#/components/schemas/const_ap_esl_versions'
description: List of Available AP ESL Versions
ConstTrafficTypes:
content:
application/json:
examples:
Example:
$ref: '#/components/examples/ConstTrafficTypesExample'
schema:
$ref: '#/components/schemas/const_traffic_types'
application/vnd.api+json:
examples:
Example:
$ref: '#/components/examples/ConstTrafficTypesExample'
schema:
$ref: '#/components/schemas/const_traffic_types'
description: List of Traffic Types
ConstLanguages:
content:
application/json:
examples:
Example:
$ref: '#/components/examples/ConstLanguagesExample'
schema:
$ref: '#/components/schemas/const_languages'
application/vnd.api+json:
examples:
Example:
$ref: '#/components/examples/ConstLanguagesExample'
schema:
$ref: '#/components/schemas/const_languages'
description: List of Languages
ConstInsightMetrics:
content:
application/json:
examples:
Example:
$ref: '#/components/examples/ConstInsightMetricsExample'
schema:
$ref: '#/components/schemas/const_insight_metrics'
application/vnd.api+json:
examples:
Example:
$ref: '#/components/examples/ConstInsightMetricsExample'
schema:
$ref: '#/components/schemas/const_insight_metrics'
description: Insight Metrics Definition
ConstCountries:
content:
application/json:
examples:
Example:
$ref: '#/components/examples/ConstCountriesExample'
schema:
$ref: '#/components/schemas/const_countries'
application/vnd.api+json:
examples:
Example:
$ref: '#/components/examples/ConstCountriesExample'
schema:
$ref: '#/components/schemas/const_countries'
description: List of Countries
ConstGatewayApplications:
content:
application/json:
examples:
Example:
$ref: '#/components/examples/ConstGatewayApplicationsExample'
schema:
$ref: '#/components/schemas/const_gateway_applications_definitions'
application/vnd.api+json:
examples:
Example:
$ref: '#/components/examples/ConstGatewayApplicationsExample'
schema:
$ref: '#/components/schemas/const_gateway_applications_definitions'
description: List of Alarm Definitions
HTTP429:
content:
application/json:
examples:
Example:
$ref: '#/components/examples/HTTP429Example'
schema:
$ref: '#/components/schemas/response_http429'
application/vnd.api+json:
examples:
Example:
$ref: '#/components/examples/HTTP429Example'
schema:
$ref: '#/components/schemas/response_http429'
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
ConstLicenseTypes:
content:
application/json:
examples:
Example:
$ref: '#/components/examples/ConstLicenseTypesExample'
schema:
$ref: '#/components/schemas/const_license_types'
application/vnd.api+json:
examples:
Example:
$ref: '#/components/examples/ConstLicenseTypesExample'
schema:
$ref: '#/components/schemas/const_license_types'
description: List of License Types
HTTP400:
content:
application/json:
examples:
Example:
$ref: '#/components/examples/HTTP400Example'
schema:
$ref: '#/components/schemas/response_http400'
application/vnd.api+json:
examples:
Example:
$ref: '#/components/examples/HTTP400Example'
schema:
$ref: '#/components/schemas/response_http400'
description: Bad Syntax
parameters:
country_code:
description: Country code, in two-character
in: query
name: country_code
schema:
examples:
- US
pattern: ^[a-zA-Z]{2}$
type: string
securitySchemes:
apiToken:
description: "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 equal or less privileges.\n\n**Format**:\n API Token value format is `Token {apitoken}`\n\n**Notes**:\n* an API token generated for a specific admin has the same privilege as the user\n* an API token will be automatically removed if not used for > 90 days\n* SSO admins cannot generate these API tokens. Refer Org level API tokens which can have privileges of a specific Org/Site for more information."
in: header
name: Authorization
type: apiKey
basicAuth:
description: While our current UI uses Session / Cookie-based authentication, it’s also possible to do Basic Auth.
scheme: basic
type: http
csrfToken:
description: "This protects the website against [Cross Site Request Forgery](https://en.wikipedia.org/wiki/Cross-site_request_forgery), all the POST / PUT / DELETE APIs needs to have CSRF token in the AJAX Request header when using Login/Password authentication (with or without MFA)\n\n\nThe CSRF Token is sent back by Mist in the Cookies from the Login Response API Call:\n`cookies[csrftoken]` \n\nThe CSRF Token must be added in the HTTP Request Headers:\n```\nX-CSRFToken: vwvBuq9qkqaKh7lu8tNc0gkvBfEaLAmx\n```"
in: header
name: X-CSRFToken
type: apiKey